Зачем интегрировать OpenClaw с WhatsApp

WhatsApp остаётся самым популярным мессенджером в мире с аудиторией свыше 2,5 млрд пользователей. Интеграция с OpenClaw превращает его в полноценный интерфейс управления ИИ-агентом: отправляйте задачи текстом, получайте результаты, контролируйте автоматизацию прямо из чата. Если вы хотите сначала разобраться в базовых возможностях платформы, прочитайте полный гид по OpenClaw.

Предварительные требования

Перед настройкой убедитесь, что у вас есть одно из следующего:

Вариант A — WhatsApp Business API (рекомендуется для продакшена):

Подтверждённый аккаунт Meta Business Suite
Доступ к WhatsApp Cloud API или одобренный BSP-партнёр (Twilio, 360dialog, Infobip)
Webhook-эндпоинт с HTTPS (можно через ngrok при локальной разработке)

Вариант B — Неофициальная библиотека (для тестирования):

Библиотека whatsapp-web.js или baileys (Node.js)
Отдельный номер телефона, не привязанный к основному аккаунту
Понимание рисков: Meta может заблокировать номер за нарушение ToS

Требования к окружению

OpenClaw версии 2.1.0 и выше
Node.js 20+ или Python 3.11+
Установленный и настроенный основной модуль OpenClaw

Пошаговая настройка

Шаг 1. Получение токена WhatsApp Business API

Перейдите в Meta for Developers и создайте приложение типа Business.
Добавьте продукт WhatsApp в панели приложения.
В разделе WhatsApp > API Setup скопируйте временный токен доступа.
Получите постоянный токен через System User в Business Settings.
Запишите PHONE_NUMBER_ID и WABA_ID — они потребуются для конфига.

Шаг 2. Настройка конфигурационного файла OpenClaw

Откройте файл ~/.openclaw/config.yaml и добавьте блок интеграции:

integrations:
  whatsapp:
    enabled: true
    provider: "cloud_api"          # или "baileys" для неофициальной
    access_token: "EAAG..."        # токен Meta
    phone_number_id: "1234567890"
    verify_token: "my_secret_token"
    webhook_url: "https://yourdomain.com/webhook/whatsapp"
    allowed_numbers:               # whitelist для безопасности
      - "+79991234567"
      - "+79997654321"
    rate_limit:
      messages_per_minute: 30
      media_per_hour: 50

Шаг 3. Регистрация вебхука

curl -X POST "https://graph.facebook.com/v19.0/<PHONE_NUMBER_ID>/subscriptions" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d "callback_url=https://yourdomain.com/webhook/whatsapp" \
  -d "verify_token=my_secret_token" \
  -d "fields=messages"

Шаг 4. Запуск и проверка

openclaw start --integration whatsapp --verbose

Отправьте тестовое сообщение с разрешённого номера:

/ping

Агент должен ответить: Pong! OpenClaw v2.x активен.

Доступные команды и возможности

Текстовые операции

Команда	Описание	Пример
`<задача>`	Выполнить произвольную задачу	`Открой браузер и найди курс доллара`
`/status`	Статус агента и активных задач	`/status`
`/stop`	Прервать текущую задачу	`/stop`
`/history`	Последние 10 выполненных задач	`/history`

Работа с медиафайлами

OpenClaw умеет принимать и отправлять через WhatsApp:

Изображения (JPEG, PNG до 5 МБ) — анализ содержимого, OCR
Документы (PDF, DOCX до 100 МБ) — извлечение и обработка текста
Голосовые сообщения — транскрибация и выполнение команд голосом
Видео (до 16 МБ) — анализ первых кадров

Пример сценария автоматизации

Пользователь: Собери отчёт по продажам из Google Sheets за март и отправь PDF на почту boss@company.com
OpenClaw: Начинаю. Открываю Google Sheets...
[через 45 секунд]
OpenClaw: Готово. PDF с отчётом отправлен. Файл также сохранён в /reports/march_2026.pdf

Ограничения и лимиты

Лимиты WhatsApp Cloud API

Уровень 1 (новые аккаунты): 1 000 уникальных получателей в сутки
Уровень 2: 10 000 получателей в сутки
Уровень 3: 100 000 получателей в сутки
Повышение уровня происходит автоматически при достижении порогов качества

Технические ограничения

Шаблонные сообщения обязательны для инициации разговора (не для ответов)
Окно бесплатного обслуживания: 24 часа после последнего сообщения от пользователя
Нельзя создавать группы или добавлять участников программно через Cloud API
Статусы прочтения доступны только при явном согласии пользователя

Сравнение с Telegram-интеграцией

Параметр	WhatsApp	Telegram
Простота настройки	Средняя (нужен Business API)	Высокая (только токен бота)
Охват аудитории	Максимальный (2,5 млрд)	Высокий (900 млн)
Лимиты сообщений	Строгие (тарифы Meta)	Мягкие (30 msg/sec по умолчанию)
Медиафайлы	До 100 МБ документы	До 2 ГБ (Telegram Premium)
Групповые чаты	Ограниченно	Полная поддержка
Стоимость API	Платно (после 1000 сообщ./мес.)	Бесплатно
Официальность	Только официальный API	Официальный Bot API

Telegram предпочтительнее для технических пользователей и команд. WhatsApp выигрывает, когда нужно работать с аудиторией, которая не пользуется Telegram. Подробнее о возможностях агента читайте в разделе навыков OpenClaw.

Практические сценарии использования

Мониторинг и оповещения. Настройте агент на мониторинг сайта и отправку сообщения в WhatsApp при падении сервера или аномальных метриках.

Клиентская поддержка. OpenClaw отвечает на типовые вопросы, эскалирует сложные случаи человеку, ведёт историю обращений в CRM.

Личная продуктивность. Диктуйте задачи голосовыми сообщениями во время езды — агент транскрибирует и выполняет их к вашему возвращению.

Управление файлами. Отправьте фото документа — OpenClaw распознает текст, сохранит в нужную папку Google Drive и внесёт данные в таблицу.

Полный список поддерживаемых интеграций доступен в разделе интеграции OpenClaw.