Интеграция Clawdbot с WhatsApp

Обзор интеграции Clawdbot с WhatsApp

Интеграция Clawdbot с WhatsApp позволяет подключить вашего персонального AI-ассистента напрямую к WhatsApp, самой популярной платформе обмена сообщениями в мире. Clawdbot использует WhatsApp Web через Baileys, при этом Gateway владеет сеансом. Это позволяет автоматизировать разговоры, получать интеллектуальные ответы и управлять сообщениями WhatsApp с помощью автоматизации на базе ИИ.

Зачем использовать Clawdbot с WhatsApp?

WhatsApp используют более 2 миллиардов человек по всему миру. Интегрируя Clawdbot с WhatsApp, вы открываете мощные возможности ИИ:

Быстрая настройка (для начинающих)

1. По возможности используйте отдельный номер телефона (рекомендуется)
2. Настройте WhatsApp в ~/.clawdbot/clawdbot.json
3. Запустите clawdbot channels login для сканирования QR-кода (Связанные устройства)
4. Запустите gateway

Минимальная конфигурация:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Получение номера телефона

WhatsApp требует реальный номер мобильного телефона для верификации. VoIP и виртуальные номера обычно блокируются. Существует два поддерживаемых способа запуска Clawdbot в WhatsApp:

Выделенный номер (рекомендуется)

Используйте отдельный номер телефона для Clawdbot WhatsApp. Это обеспечивает лучший пользовательский опыт с чистой маршрутизацией и без странностей самочата.

Идеальная настройка: запасной/старый Android-телефон + eSIM. Оставьте его подключенным к Wi-Fi и питанию, и свяжите через QR.

Совет по WhatsApp Business: Вы можете использовать WhatsApp Business на том же устройстве с другим номером, чтобы держать личный WhatsApp отдельно.

Пример конфигурации (выделенный номер, список разрешений для одного пользователя):

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Личный номер (запасной вариант)

Быстрый запасной вариант: запустите Clawdbot на своем собственном номере. Отправьте сообщение себе (WhatsApp "Отправить сообщение себе") для тестирования.

Пример конфигурации (личный номер, самочат):

{
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

Советы по получению номеров

• Локальная eSIM от мобильного оператора вашей страны (наиболее надежно)
• Предоплаченная SIM-карта — дешево, нужно только получить одно SMS для верификации
• Избегайте: TextNow, Google Voice, большинство сервисов "бесплатных SMS" — WhatsApp агрессивно блокирует их

Совет: Номеру нужно получить только одно SMS для верификации. После этого сеансы WhatsApp Web сохраняются через creds.json.

Настройка Clawdbot WhatsApp

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

Перед подключением Clawdbot к WhatsApp убедитесь, что у вас есть:

• Clawdbot установлен на вашем устройстве
• Аккаунт WhatsApp с активным номером телефона
• Node.js 22 или выше

Шаг 1: Настройка канала WhatsApp

Добавьте конфигурацию WhatsApp в ваш ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Шаг 2: Вход с QR-кодом

Запустите команду входа Clawdbot WhatsApp:

clawdbot channels login

Откройте WhatsApp на телефоне, перейдите в Настройки > Связанные устройства > Связать устройство, и отсканируйте QR-код, отображаемый Clawdbot.

Для входа с несколькими аккаунтами:

clawdbot channels login --account <id>

Шаг 3: Запуск Gateway

clawdbot gateway --port 18789

Шаг 4: Проверка подключения

Подтвердите, что ваша интеграция Clawdbot WhatsApp работает:

clawdbot channels status whatsapp

Функции Clawdbot WhatsApp

Интеллектуальная обработка сообщений

Clawdbot WhatsApp обрабатывает входящие сообщения и генерирует контекстуальные ответы. ИИ понимает историю разговора и предоставляет релевантные ответы. Модель видит достаточно контекста, чтобы понимать цитируемые ответы.

Варианты политики личных сообщений

Поддержка групповых сообщений

Clawdbot WhatsApp поддерживает групповые разговоры. Прямые чаты используют основной сеанс агента; группы остаются изолированными.

Поддержка медиа

Clawdbot WhatsApp может обрабатывать и отвечать на:

• Текстовые сообщения
• Изображения (с ИИ зрения)
• Голосовые сообщения (PTT аудио с транскрипцией)
• Документы
• Сообщения о местоположении

Уведомления о прочтении

Clawdbot WhatsApp может отправлять уведомления о прочтении при настройке.

Реакции подтверждения

Автоматическая реакция при получении для подтверждения получения сообщения.

Конфигурация Clawdbot WhatsApp

Пример полной конфигурации

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567", "+10987654321"],
      "configWrites": true,
      "selfChatMode": false
    }
  }
}

Записи конфигурации

По умолчанию WhatsApp разрешено записывать обновления конфигурации, инициированные /config set|unset. Отключить с помощью:

{
  "channels": {
    "whatsapp": {
      "configWrites": false
    }
  }
}

Хранение учетных данных Clawdbot WhatsApp

Clawdbot безопасно хранит учетные данные WhatsApp:

~/.clawdbot/credentials/whatsapp/<accountId>/creds.json

• Резервная копия в creds.json.bak (восстанавливается при повреждении)
• Совместимость с устаревшими версиями: старые установки хранили файлы Baileys непосредственно в ~/.clawdbot/credentials/

Данные вашего сеанса WhatsApp остаются на вашей локальной машине, обеспечивая конфиденциальность.

Устранение неполадок Clawdbot WhatsApp

Потеря соединения

Если Clawdbot WhatsApp отключается:

1. Проверьте интернет-соединение
2. Повторная аутентификация: clawdbot channels login
3. Просмотрите логи: cat /tmp/clawdbot/whatsapp.log

Сообщения не отправляются

Если Clawdbot WhatsApp не может отправить сообщения:

1. Проверьте статус аккаунта: clawdbot channels status whatsapp
2. Проверьте конфигурацию списка разрешений
3. Убедитесь, что gateway Clawdbot запущен
4. Для исходящих отправок требуется активный слушатель

QR-код истек

Если QR-код Clawdbot WhatsApp истек:

clawdbot channels logout
clawdbot channels login

Выход

Выход удаляет состояние аутентификации WhatsApp (но сохраняет общий oauth.json):

clawdbot channels logout
# или для конкретного аккаунта
clawdbot channels logout --account <id>

Лучшие практики Clawdbot WhatsApp

1. Используйте выделенный номер: Отдельный номер телефона обеспечивает лучший опыт
2. Установите четкие границы: Настройте списки разрешений для контроля доступа Clawdbot WhatsApp
3. Мониторьте использование: Регулярно просматривайте логи Clawdbot WhatsApp
4. Регулярно обновляйте: Поддерживайте Clawdbot в актуальном состоянии для последней совместимости с WhatsApp
5. Резервное копирование учетных данных: Периодически создавайте резервные копии учетных данных Clawdbot WhatsApp

Почему не Twilio?

Номера WhatsApp Business плохо подходят для персонального ассистента:

• Meta применяет 24-часовое окно ответа
• Использование большого объема вызывает агрессивную блокировку
• Бизнес-аккаунты не предназначены для сообщений персонального ассистента

Следующие шаги

• Интеграция Clawdbot с Telegram - Подключите Clawdbot к Telegram
• Интеграция Clawdbot с Discord - Настройте Clawdbot в Discord
• Руководство по настройке Clawdbot - Полное руководство по установке