OpenClaw: полная настройка мессенджеров за 10 минут
OpenClaw поддерживает 5 транспортов из коробки. Настройка каждого — 2 минуты в мастере (openclaw при первом запуске) или через конфиг. Разбираем каждый пошагово.
1. Telegram Bot — самый простой
Создание бота
- Откройте @BotFather в Telegram
- Отправьте
/newbot - Введите имя бота (например:
My Claw Bot) - Введите username (должен заканчиваться на
bot:myclawbot) - Скопируйте токен (формат:
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-код
Подключение
- В мастере выберите WhatsApp
- В терминале появится QR-код
- Откройте WhatsApp на телефоне → Настройки → Linked Devices → Link a Device
- Отсканируйте QR-код
- Сессия сохраняется в
~/.config/openclaw/sessions/whatsapp/
Важные нюансы
- Работает через Baileys (неофициальный WebSocket клиент)
- Может требовать переподключение раз в несколько дней
- Групповые чаты: бот должен быть админом или добавлен участником
- Поддерживает: текст, изображения, документы, голосовые, локации
Мульти-аккаунт
Можно подключить несколько WhatsApp номеров — создайте отдельные сессии в ~/.config/openclaw/sessions/whatsapp_1/, whatsapp_2/ и укажите в config.toml.
3. Discord Bot — через Developer Portal
Создание приложения
- Зайдите на Discord Developer Portal
- New Application → имя:
OpenClaw Bot - Bot → Reset Token → скопируйте токен
- Privileged Gateway Intents (ОБЯЗАТЕЛЬНО включите):
- ✅ Message Content Intent — чтение сообщений
- ✅ Server Members Intent — список участников
- ✅ Presence Intent — статусы онлайн/офлайн
- OAuth2 → URL Generator → Scopes:
bot+applications.commands- Bot Permissions:
Send Messages,Embed Links,Attach Files,Read Message History,Use Slash Commands,Manage Messages
- Bot Permissions:
- Скопируйте сгенерированный URL → откройте в браузере → добавьте бота на сервер
Slash Commands
OpenClaw автоматически регистрирует слэш-команды при запуске: /skill, /agent, /help, /undo. В Discord они появляются как нативные команды.
4. Slack App — через api.slack.com
Создание App
- Зайдите на api.slack.com/apps → Create New App → From scratch
- App Name:
OpenClaw, Workspace: ваш - 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— упоминания бота
- Install to Workspace → разрешить
- Bot User OAuth Token (
xoxb-...) → вставьте в мастере OpenClaw - Event Subscriptions → Enable → Request URL:
https://your.domain/slack/events(нужен вебхук/SSL) - Subscribe to bot events:
app_mention,message.channels,message.im
5. Matrix — децентрализованный
- Зарегистрируйте аккаунт на любом Matrix-хомсервере (matrix.org, ваш сервер)
- Создайте Access Token: Element → Settings → Security → Access Tokens
- В мастере: Matrix → Homeserver URL, User ID, Access Token
- Пригласите бота в комнаты:
/invite @openclaw:matrix.org
6. Настройка прав и групповых чатов
| Мессенджер | Групповые чаты | Приватные | Админ-права |
|---|---|---|---|
| Telegram | ✅ (добавьте бота в группу) | ✅ | Нужны для удаления сообщений |
| ✅ (бот должен быть админом) | ✅ | Не обязательны | |
| 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 память), но транспорты независимы.
Чек-лист настройки ✅
- [ ] Telegram: токен от @BotFather,
/setprivacy Disable - [ ] WhatsApp: QR отсканирован, сессия сохранена
- [ ] Discord: токен, 3 Intents включены, бот на сервере
- [ ] Slack: Bot Token + Signing Secret, Event Subscriptions, бот в workspace
- [ ] Matrix: Access Token, бот в комнатах
- [ ] Тест: напишите боту
/helpв каждом мессенджере - [ ] Тест:
/skill deployв Telegram → проверьте уведомление
