Подключение к WhatsApp
Цели урока
После прохождения этого урока вы сможете:
- 1Настроить подключение NanoClaw к WhatsApp
- 2Понять варианты интеграции: Business API vs Baileys
- 3Сконфигурировать webhook для получения сообщений
- 4Провести тестовое взаимодействие с агентом
Подключение NanoClaw к WhatsApp
WhatsApp — основной интерфейс общения с NanoClaw. После настройки вы сможете писать своему агенту как обычному контакту в WhatsApp и получать ответы в реальном времени.
Два варианта подключения
| Вариант | Плюсы | Минусы |
|---|---|---|
| WhatsApp Business API | Официальный, стабильный, поддержка Meta* | Требует верификации бизнеса, платный |
| Baileys (open-source) | Бесплатный, быстрая настройка | Неофициальный, возможны блокировки аккаунта |
Вариант A: WhatsApp Business API
Зарегистрируйтесь на developers.facebook.com
Создайте приложение типа «Business»
Подключите WhatsApp Business API
Получите Phone Number ID и Access Token
Настройте Webhook URL на ваш сервер NanoClaw
Вариант B: Baileys Bridge (для тестирования)
Baileys — популярная open-source библиотека для работы с WhatsApp Web. NanoClaw поддерживает Baileys как альтернативу официальному API. Это удобно для быстрого тестирования и личного использования.
# В .env файле указать режим Baileys
WHATSAPP_MODE=baileys
# Запустить NanoClaw
npm start
# В терминале появится QR-код
# Отсканируйте его камерой телефона через WhatsApp > Linked DevicesНастройка Webhook (для Business API)
# В .env добавить настройки webhook
WHATSAPP_MODE=business_api
WHATSAPP_PHONE_NUMBER_ID=ваш-phone-number-id
WHATSAPP_ACCESS_TOKEN=ваш-access-token
WHATSAPP_VERIFY_TOKEN=случайная-строка-для-верификации
# Webhook URL (должен быть доступен из интернета)
# https://ваш-домен.com/webhook/whatsappТестирование подключения
После настройки WhatsApp отправьте тестовое сообщение:
Откройте WhatsApp на телефоне
Найдите номер вашего NanoClaw-агента (или отсканируйте QR для Baileys)
Отправьте сообщение: «Привет, кто ты?»
Агент должен ответить, представившись и описав свои возможности
Попробуйте дать задачу: «Найди последние новости про AI»
Устранение проблем
| Проблема | Решение |
|---|---|
| Агент не отвечает | Проверьте логи NanoClaw (npm start показывает их в терминале) |
| QR-код не сканируется | Обновите WhatsApp до последней версии и попробуйте снова |
| Ошибка «unauthorized» | Проверьте правильность ANTHROPIC_API_KEY в .env |
| Webhook не получает сообщения | Убедитесь, что URL доступен извне (используйте ngrok для тестирования) |
| Сообщения приходят с задержкой | Проверьте контейнерный движок — первый запуск контейнера занимает больше времени |
Baileys — неофициальная библиотека. Meta* может заблокировать аккаунт при подозрительной активности. Для production-использования рекомендуется WhatsApp Business API.
*Meta признана в РФ экстремистской организацией и запрещена.
Для тестирования на локальной машине без публичного IP используйте ngrok: «npx ngrok http 3001» — он создаст временный публичный URL для вашего webhook.