Урок 2: Подключение WhatsApp

Чему вы научитесь

• Понимать, как OpenClaw подключается к WhatsApp (библиотека Baileys)
• Подключать WhatsApp через QR-код
• Настраивать безопасность через DM Pairing
• Знать ограничения и особенности WhatsApp-канала
• Отправлять и получать сообщения через WhatsApp

Как это работает

В отличие от Telegram, у WhatsApp нет открытого Bot API. OpenClaw использует библиотеку Baileys — open-source реализацию протокола WhatsApp Web.

Что это значит

• Вы подключаете свой реальный аккаунт WhatsApp (не бота)
• Подключение происходит через QR-код, как в WhatsApp Web
• OpenClaw работает как ещё одно устройство, привязанное к вашему номеру
• Все сообщения, которые вы получаете в WhatsApp, видит OpenClaw

Важные замечания

• WhatsApp позволяет подключить до 4 дополнительных устройств
• OpenClaw занимает одно из этих мест
• Если вы используете WhatsApp Web, останется место для OpenClaw
• Ваш основной телефон должен быть подключён к интернету (хотя бы раз в 14 дней)

Шаг 1. Подключение WhatsApp

Выполните команду:

openclaw channels login --channel whatsapp

В терминале появится QR-код:

Scan this QR code with WhatsApp on your phone:

█████████████████████████████
█████████████████████████████
████ ▄▄▄▄▄ █▀▄▀█ ▄▄▄▄▄ ████
████ █   █ █▄ ▀█ █   █ ████
████ █▄▄▄█ █ ▄██ █▄▄▄█ ████
████▄▄▄▄▄▄▄█▄▀▄█▄▄▄▄▄▄▄████
█████████████████████████████

Waiting for scan...

Как отсканировать

1. Откройте WhatsApp на телефоне.
2. Перейдите в Настройки (три точки) -> Связанные устройства.
3. Нажмите Привязать устройство.
4. Отсканируйте QR-код из терминала.

После сканирования:

Successfully connected to WhatsApp!
  Phone: +7 (999) 123-45-67
  Name: Алексей
  Platform: openclaw

Шаг 2. DM Pairing (привязка)

После подключения настройте DM Policy (dmPolicy) — механизм безопасности, который определяет, кому бот будет отвечать.

Зачем это нужно

В WhatsApp вам могут писать любые контакты. Без настройки dmPolicy OpenClaw будет отвечать всем — это небезопасно и может расходовать ваш API-бюджет.

Настройка

По умолчанию используется режим "pairing". Для одобрения новых номеров используйте команды:

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

Рекомендуется использовать режим "allowlist" с явным списком разрешённых номеров и выделенный номер телефона для OpenClaw.

Конфигурация доступа

В конфигурации (обычно ~/.openclaw/config.json или через CLI):

{
  "channels": {
    "whatsapp": {
      "enabled": true,

      // Кто может писать
      "dmPolicy": "allowlist",  // Только разрешённые номера
      "allowFrom": [
        "+79991234567"           // Ваш номер
      ]
    }
  }
}

Рекомендуется выделенный номер и режим allowlist.

Добавление других пользователей

Чтобы OpenClaw отвечал другим людям (например, членам семьи), добавьте их номера в allowFrom:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": [
        "+79991234567",    // Вы
        "+79997654321"     // Член семьи
      ]
    }
  }
}

Шаг 3. Проверка работы

Отправьте себе сообщение в WhatsApp (через другой номер или групповой чат):

Привет! Это тестовое сообщение для OpenClaw.

Проверьте статус:

openclaw channels status --channel whatsapp

Channel: whatsapp
  Status: connected
  Phone: +7 (999) 123-45-67
  DM Policy: allowlist
  Allowed numbers: 1
  Active sessions: 0
  Last message: 2s ago

Особенности WhatsApp-канала

Что работает

• Текстовые сообщения (входящие и исходящие)
• Файлы: изображения, документы, аудио
• Групповые чаты (с настройкой активации)
• Статусы доставки и прочтения
• Реакции на сообщения

Ограничения

Рекомендации по безопасности

1. Не отправляйте массовые сообщения через OpenClaw — WhatsApp это считает спамом
2. Настройте dmPolicy — используйте режим allowlist с allowFrom, чтобы не позволять незнакомым людям использовать ваш AI
3. Следите за расходами — команда /usage покажет, сколько токенов потрачено
4. Рассмотрите отдельный номер — для OpenClaw можно купить отдельную SIM-карту

Групповые чаты WhatsApp

Добавление в группу

OpenClaw автоматически видит все групповые чаты, в которых состоит ваш аккаунт. Настройте, в каких группах бот должен отвечать:

{
  "channels": {
    "whatsapp": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["+79991234567"],
      "groups": [
        "120363012345678901@g.us"   // ID группы
      ]
    }
  }
}

Режим mention часто реализуется через логику агента.

Как узнать ID группы

В логах OpenClaw (openclaw logs -f) отправьте сообщение в группу — в логах появится ID:

[whatsapp] Message from group 120363012345678901@g.us: "тест"

Режимы активации в группах

• mention: бот отвечает только когда упоминают его имя (в WhatsApp это обычно имя контакта)
• always: бот отвечает на каждое сообщение
• keyword: бот реагирует на ключевые слова

Переподключение

Если WhatsApp-сессия разорвалась (например, после обновления приложения), переподключитесь:

# Отключение
openclaw channels logout --channel whatsapp

# Повторное подключение
openclaw channels login --channel whatsapp

Сканируйте QR-код заново. Все настройки (dmPolicy, allowFrom, groups) сохранятся.

Попробуйте сами

1. Подключите WhatsApp — выполните openclaw channels login --channel whatsapp и отсканируйте QR-код.

2. Настройте dmPolicy — установите режим allowlist и добавьте свой номер в allowFrom.

3. Проверьте работу — отправьте боту 3 сообщения:

   • Текстовый вопрос
   • Изображение с просьбой описать
   • Голосовое сообщение

4. Настройте доступ — установите "dmPolicy": "allowlist" и добавьте свой номер в allowFrom, чтобы убедиться, что посторонние не могут использовать бота.

5. Проверьте статус — выполните openclaw channels status --channel whatsapp и /usage.

Ключевые выводы

• WhatsApp подключается через библиотеку Baileys — не через официальный API, а через ваш личный аккаунт
• Подключение происходит сканированием QR-кода, как в WhatsApp Web
• Настройте dmPolicy (рекомендуется "allowlist" с allowFrom) для безопасности и ограничения доступа к боту
• WhatsApp имеет ограничения: нет официального Bot API, максимум 4 связанных устройства, телефон должен быть онлайн раз в 14 дней, риск бана при спаме
• Для безопасности используйте "dmPolicy": "allowlist", выделенный номер и следите за расходами API

Следующий урок

Урок 3: Discord, Slack и другие каналы — подключим Discord, Slack, Signal и другие платформы, а также настроим мультиканальную работу.