OpenClaw + WhatsApp

Примечание: OpenClaw ранее назывался MoltBot и Clawdbot. Все команды взаимозаменяемы (openclaw, moltbot, clawdbot). WhatsApp — самый популярный мессенджер в мире. OpenClaw подключается через Baileys (reverse-engineered WhatsApp Web протокол).

⚠️ Важно

WhatsApp не имеет официального Bot API. Baileys — это неофициальная библиотека. Риски:

• WhatsApp может заблокировать номер
• Нет гарантий стабильности
• Используй отдельный номер, не основной

Для бизнеса рассмотри официальный WhatsApp Business API.

---

Что получим

• ✅ AI-ассистент в WhatsApp
• ✅ Личные сообщения и группы
• ✅ Голосовые сообщения
• ✅ Изображения и документы
• ✅ Мультидевайс (телефон + OpenClaw)

---

Шаг 1: Подготовка

Отдельный номер

Рекомендую использовать отдельную SIM-карту:

• Виртуальные номера (eSIM)
• Старая SIM
• Бизнес-номер

Регистрация WhatsApp

1. Установи WhatsApp на телефон с этим номером
2. Пройди верификацию
3. Настрой профиль

---

Шаг 2: Конфигурация OpenClaw

Включаем WhatsApp канал

# ~/.openclaw/openclaw.yaml
channels:
  whatsapp:
    enabled: true
    
    # Путь для хранения сессии
    sessionPath: "~/.openclaw/whatsapp-session"
    
    # Автопереподключение
    autoReconnect: true
    
    # Логирование
    logLevel: "info"

---

Шаг 3: Первый запуск и QR-код

Запускаем OpenClaw

openclaw gateway

Сканируем QR-код

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

█████████████████████████████████
█████████████████████████████████
████ ▄▄▄▄▄ █▀▄▀▄█ ▀█ ▄▄▄▄▄ ████
████ █   █ █▄▀▄ █▀▄█ █   █ ████
████ █▄▄▄█ █▀▀▀▀▀▀▀█ █▄▄▄█ ████
...

1. Открой WhatsApp на телефоне
2. Settings → Linked Devices → Link a Device
3. Отсканируй QR-код

Успешное подключение

[whatsapp] Connected!
[whatsapp] Logged in as: +1234567890
[whatsapp] Ready to receive messages

---

Шаг 4: Тестирование

Отправь сообщение

С другого номера напиши на номер бота:

“Привет! Ты работаешь?”

OpenClaw должен ответить.

Проверь логи

journalctl -u moltbot -f | grep whatsapp

---

Настройка поведения

DM Pairing

gateway:
  dmPairing:
    enabled: true
    approvalMode: "manual"
    
channels:
  whatsapp:
    # Приветственное сообщение для новых контактов
    welcomeMessage: |
      👋 Привет! Это AI-ассистент.
      Отправь любое сообщение чтобы начать.

Группы

channels:
  whatsapp:
    groups:
      enabled: true
      # Отвечать только при упоминании
      mentionOnly: true
      # Или при reply на сообщение бота
      replyOnly: true

Голосовые сообщения

agent:
  transcription:
    enabled: true
    provider: "openai"  # Whisper API
    
  # Ответы голосом (опционально)
  tts:
    enabled: true
    provider: "elevenlabs"

---

Мультидевайс

WhatsApp поддерживает до 4 связанных устройств. OpenClaw занимает одно из них.

Проверка связанных устройств

В WhatsApp на телефоне: Settings → Linked Devices

Увидишь “OpenClaw” или “Unknown device”.

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

Если сессия слетела:

# Удаляем старую сессию
rm -rf ~/.openclaw/whatsapp-session

# Перезапускаем
openclaw gateway
# Сканируем новый QR-код

---

Безопасность

Изоляция номера

Используй отдельный номер для бота. Если заблокируют — не потеряешь основной аккаунт.

Rate Limiting

WhatsApp может посчитать спамом частые сообщения:

channels:
  whatsapp:
    rateLimit:
      messagesPerMinute: 10
      messagesPerHour: 100

Нет автоответов в новых чатах

channels:
  whatsapp:
    # Игнорировать первое сообщение от неизвестных
    ignoreFirstMessage: true

---

Troubleshooting

QR-код не появляется

# Проверь зависимости
npm list @whiskeysockets/baileys

# Переустанови если нужно
npm install @whiskeysockets/baileys@latest

”Connection closed”

1. Проверь интернет
2. Удали сессию и пересканируй QR
3. Проверь не заблокирован ли номер

WhatsApp на телефоне вылогинивает бота

• Убедись что телефон онлайн
• Не выходи из WhatsApp на телефоне
• Проверь что мультидевайс включён

Сообщения не доходят

channels:
  whatsapp:
    # Увеличь таймаут
    messageTimeout: 30000
    
    # Включи ретраи
    retries: 3

---

Альтернатива: WhatsApp Business API

Для production и бизнеса используй официальный API:

1. Зарегистрируйся на Meta Business
2. Подключи WhatsApp Business API
3. Настрой OpenClaw:

channels:
  whatsapp:
    provider: "cloud-api"  # Вместо baileys
    phoneNumberId: "123456789"
    accessToken: "your-access-token"

Преимущества:

• Официальный, стабильный
• Не заблокируют
• Webhooks вместо polling
• Шаблоны сообщений

Недостатки:

• Платный
• Требует верификацию бизнеса
• Сложнее настроить

---

Итог

WhatsApp + OpenClaw работает отлично для личного использования. Для бизнеса — рассмотри официальный API.

Ключевое:

• Отдельный номер ✓
• QR-авторизация ✓
• Rate limiting ✓
• Резервный план если заблокируют ✓