Подключение WhatsApp
WhatsApp — ещё один канал для общения с AI-агентом OpenClaw. В отличие от Telegram и Discord, WhatsApp подключается не через токен бота, а через QR-код — бот работает от имени вашего аккаунта.
Как это работает
OpenClaw использует протокол WhatsApp Web для подключения к вашему аккаунту. Это означает:
- Нет отдельного Bot API — бот работает через ваш личный номер
- Подключение через QR-код, как WhatsApp Web
- Агент может получать и отправлять сообщения от вашего имени
Важно. WhatsApp не предоставляет официального Bot API для обычных пользователей. Подключение через QR-код — неофициальный метод. Используйте на свой страх и риск. При активном использовании WhatsApp может временно заблокировать аккаунт.
Подключение
Создайте агента
В личном кабинете при создании агента включите WhatsApp.
Дождитесь запуска
Подождите, пока агент перейдёт в статус «Работает» (1-2 минуты). QR-код для паринга появится в личном кабинете.
Отсканируйте QR-код
Откройте WhatsApp на телефоне → Настройки → Связанные устройства → Привязка устройства → отсканируйте QR-код.
После успешной привязки бот начнёт получать сообщения.
Альтернативный способ: через SSH
Если QR-код не отображается в личном кабинете или вам нужно повторно пройти паринг, можно сделать это через SSH:
- Скопируйте команду SSH-подключения с дашборда и выполните её в терминале
- В терминале контейнера выполните:
openclaw channels login --channel whatsapp - На экране появится QR-код — отсканируйте его в WhatsApp
Настройка доступа
Чат с самим собой (selfChatMode)
Самый удобный режим для личного ассистента. Агент отвечает на сообщения, которые вы пишете самому себе в WhatsApp (функция «Сообщение самому себе»). Никто другой не получает ответы бота.
Список разрешённых (allowlist)
Бот отвечает только номерам из списка. Укажите номера в международном формате (например, +79001234567).
Открытый режим
Бот отвечает на все входящие сообщения. Подходит для публичных ассистентов.
Ограничения
- Сессия может слететь — WhatsApp периодически отключает связанные устройства. Потребуется повторный QR-код
- Условия использования — автоматизация WhatsApp не одобрена официально. Риск временной блокировки аккаунта при интенсивной отправке
- Нет поддержки групп — бот работает только в личных чатах
- Повторный паринг — при слёте сессии потребуется заново отсканировать QR-код в личном кабинете или через SSH
Решение проблем
QR-код не появляется
- Убедитесь, что агент в статусе «Работает»
- Попробуйте перезапустить агента и выполнить команду паринга заново
- Проверьте, что подключились по SSH именно к контейнеру (не к серверу)
«Устройство не активно»
WhatsApp отключил связанное устройство. Это происходит, если телефон был офлайн более 14 дней или при обновлении WhatsApp.
Решение: Повторите процедуру паринга — подключитесь по SSH и выполните openclaw channels login --channel whatsapp.
Бот не отвечает
- Проверьте, что WhatsApp-сессия активна (устройство отображается в «Связанных устройствах»)
- Нажмите «Перезапустить агента» в личном кабинете
- Если не помогает — удалите агента и создайте нового, затем пройдите паринг заново
Совет. Для стабильной работы WhatsApp-бота убедитесь, что ваш телефон всегда подключён к интернету. WhatsApp отключает связанные устройства, если основное устройство долго офлайн.
Что дальше
- Веб-чат — общение с агентом в браузере
- Подключение Telegram — самый простой канал для подключения
- Подключение Discord — бот в Discord-сервере
- Настройки агента — конфигурация поведения