OpenClaw: полная настройка мессенджеров за 10 минут

OpenClaw поддерживает 5 транспортов из коробки. Настройка каждого — 2 минуты в мастере (openclaw при первом запуске) или через конфиг. Разбираем каждый пошагово.

1. Telegram Bot — самый простой

Создание бота

  1. Откройте @BotFather в Telegram
  2. Отправьте /newbot
  3. Введите имя бота (например: My Claw Bot)
  4. Введите username (должен заканчиваться на bot: myclawbot)
  5. Скопируйте токен (формат: 123456789:ABCdefGhIjkLmnOpqRsTuvWxYz)

Настройка в OpenClaw

В мастере (openclaw → Configure → Messengers → Telegram) вставьте токен. Готово!

Полезные настройки

  • /setprivacy → Disable → бот видит все сообщения в группах
  • /setjoingroups → Enable → бот может добавляться в группы
  • /setcommands — добавьте команды: start - Start, help - Help, skill - Run skill

Вебхуки vs Long Polling

  • Long Polling (дефолт): не нужен публичный IP/SSL, работает везде, включая localhost
  • Webhook: нужен HTTPS домен, быстрее, меньше нагрузка. Настройка в config.toml: webhook_url = "https://your.domain/telegram/webhook"

2. WhatsApp (Baileys) — через QR-код

Подключение

  1. В мастере выберите WhatsApp
  2. В терминале появится QR-код
  3. Откройте WhatsApp на телефоне → Настройки → Linked Devices → Link a Device
  4. Отсканируйте QR-код
  5. Сессия сохраняется в ~/.config/openclaw/sessions/whatsapp/

Важные нюансы

  • Работает через Baileys (неофициальный WebSocket клиент)
  • Может требовать переподключение раз в несколько дней
  • Групповые чаты: бот должен быть админом или добавлен участником
  • Поддерживает: текст, изображения, документы, голосовые, локации

Мульти-аккаунт

Можно подключить несколько WhatsApp номеров — создайте отдельные сессии в ~/.config/openclaw/sessions/whatsapp_1/, whatsapp_2/ и укажите в config.toml.

3. Discord Bot — через Developer Portal

Создание приложения

  1. Зайдите на Discord Developer Portal
  2. New Application → имя: OpenClaw Bot
  3. Bot → Reset Token → скопируйте токен
  4. Privileged Gateway Intents (ОБЯЗАТЕЛЬНО включите):
    • ✅ Message Content Intent — чтение сообщений
    • ✅ Server Members Intent — список участников
    • ✅ Presence Intent — статусы онлайн/офлайн
  5. OAuth2 → URL Generator → Scopes: bot + applications.commands
    • Bot Permissions: Send Messages, Embed Links, Attach Files, Read Message History, Use Slash Commands, Manage Messages
  6. Скопируйте сгенерированный URL → откройте в браузере → добавьте бота на сервер

Slash Commands

OpenClaw автоматически регистрирует слэш-команды при запуске: /skill, /agent, /help, /undo. В Discord они появляются как нативные команды.

4. Slack App — через api.slack.com

Создание App

  1. Зайдите на api.slack.com/apps → Create New App → From scratch
  2. App Name: OpenClaw, Workspace: ваш
  3. OAuth & Permissions → Bot Token Scopes (добавьте):
    • chat:write — отправка сообщений
    • channels:read, groups:read, im:read, mpim:read — чтение каналов
    • channels:history, groups:history, im:history, mpim:history — история
    • reactions:write — реакции
    • files:write — загрузка файлов
    • app_mentions:read — упоминания бота
  4. Install to Workspace → разрешить
  5. Bot User OAuth Token (xoxb-...) → вставьте в мастере OpenClaw
  6. Event Subscriptions → Enable → Request URL: https://your.domain/slack/events (нужен вебхук/SSL)
  7. Subscribe to bot events: app_mention, message.channels, message.im

5. Matrix — децентрализованный

  1. Зарегистрируйте аккаунт на любом Matrix-хомсервере (matrix.org, ваш сервер)
  2. Создайте Access Token: Element → Settings → Security → Access Tokens
  3. В мастере: Matrix → Homeserver URL, User ID, Access Token
  4. Пригласите бота в комнаты: /invite @openclaw:matrix.org

6. Настройка прав и групповых чатов

МессенджерГрупповые чатыПриватныеАдмин-права
Telegram✅ (добавьте бота в группу)✅Нужны для удаления сообщений
WhatsApp✅ (бот должен быть админом)✅Не обязательны
Discord✅ (бот на сервере)✅ (DM)Manage Messages для удаления
Slack✅ (добавьте в канал: @OpenClaw)✅ (DM)Не обязательны
Matrix✅ (пригласите в комнату)✅ (DM)Power level 100 для модерации

7. Конфиг для продвинутых (config.toml)

[messengers.telegram]
token = "123456789:ABCdef..."
webhook_url = "https://your.domain/telegram/webhook"  # опционально
allowed_users = [123456789, 987654321]  # опционально: whitelist

[messengers.whatsapp]
session_path = "~/.config/openclaw/sessions/whatsapp"
multi_device = true

[messengers.discord]
token = "MTIzNDU2Nzg5..."
# slash commands auto-register

[messengers.slack]
token = "xoxb-123456..."
signing_secret = "abcdef..."
webhook_url = "https://your.domain/slack/events"

[messengers.matrix]
homeserver = "https://matrix.org"
user_id = "@openclaw:matrix.org"
access_token = "syt_..."

8. Частые проблемы и решения

  • Telegram: бот не отвечает в группе → /setprivacy Disable у @BotFather
  • WhatsApp: QR не сканируется → перезапустите openclaw, обновите Baileys: cd openclaw && git pull && ./install.sh
  • Discord: бот не видит сообщения → включите Message Content Intent в Developer Portal
  • Slack: events не приходят → проверьте Signing Secret, SSL сертификат, URL доступность извне
  • Matrix: бот не присоединяется → проверьте Power Level в комнате (нужно 100+)

9. Мульти-мессенджер: омар везде сразу

OpenClaw может работать во всех мессенджерах одновременно. Настройте каждый в мастере или в config.toml — омар будет отвечать везде, где его добавили. Контекст общий (SQLite память), но транспорты независимы.

Чек-лист настройки ✅

  1. [ ] Telegram: токен от @BotFather, /setprivacy Disable
  2. [ ] WhatsApp: QR отсканирован, сессия сохранена
  3. [ ] Discord: токен, 3 Intents включены, бот на сервере
  4. [ ] Slack: Bot Token + Signing Secret, Event Subscriptions, бот в workspace
  5. [ ] Matrix: Access Token, бот в комнатах
  6. [ ] Тест: напишите боту /help в каждом мессенджере
  7. [ ] Тест: /skill deploy в Telegram → проверьте уведомление

Ссылки: Документация по мессенджерам | Discord #messengers