Подключение WhatsApp, Slack и Discord к OpenClaw

Один агент — множество каналов

OpenClaw спроектирован как мультиканальная система: один и тот же агент может одновременно общаться через Telegram, WhatsApp, Slack, Discord и другие платформы. Brain (ядро с языковой моделью) не привязан к конкретному мессенджеру — каналы подключаются через модуль Gateway, который транслирует сообщения между платформами и агентом. Это означает, что вы можете начать разговор в Slack на работе и продолжить его в WhatsApp по дороге домой.

Каждая платформа имеет свои особенности, ограничения и процесс настройки. В этом руководстве мы разберём интеграцию с тремя популярными платформами: WhatsApp, Slack и Discord. Для каждой — пошаговая инструкция, типичные проблемы и решения.

WhatsApp: интеграция через WhatsApp Web

Интеграция с WhatsApp в OpenClaw реализована через протокол WhatsApp Web. Это не официальный API (Meta предоставляет коммерческий WhatsApp Business API, но он требует верификации бизнеса и месячных платежей). Вместо этого OpenClaw подключается к WhatsApp так же, как приложение WhatsApp Web в вашем браузере — через сканирование QR-кода.

Для начала установите WhatsApp-адаптер:

openclaw channel install whatsapp

При первом запуске в терминале появится QR-код. Откройте WhatsApp на телефоне, перейдите в «Связанные устройства» и отсканируйте этот код. После успешной привязки OpenClaw получит доступ к вашему WhatsApp-аккаунту.

Конфигурация в config.yaml:

channels:
  whatsapp:
    enabled: true
    session_dir: ~/.openclaw/whatsapp-session/
    allowed_contacts:
      - "+79161234567"  # номер в международном формате
    auto_reconnect: true
    reconnect_interval: 30

Главная проблема: истечение сессии

Критический нюанс WhatsApp Web-интеграции — сессии истекают. WhatsApp периодически отключает связанные устройства, особенно если телефон долго находится без интернета. Когда сессия истекает, агент перестаёт получать и отправлять сообщения. Для восстановления нужно заново отсканировать QR-код.

OpenClaw смягчает эту проблему параметром auto_reconnect: система попытается восстановить сессию автоматически, используя сохранённые данные. Но если WhatsApp полностью сбросил привязку, потребуется ручное сканирование. Для отслеживания состояния подключения настройте уведомления:

channels:
  whatsapp:
    health_check:
      enabled: true
      interval: 300  # проверка каждые 5 минут
      notify_on_disconnect: true
      notify_channel: telegram  # уведомить через Telegram

Эта конфигурация заставит OpenClaw проверять состояние WhatsApp-подключения каждые 5 минут и отправлять уведомление в Telegram, если связь потеряна. Так вы сможете быстро восстановить сессию.

Slack: создание приложения и OAuth

Интеграция со Slack реализована через официальный Slack API и требует создания Slack-приложения. Процесс включает несколько этапов, но после настройки работает стабильно и не страдает от проблем с истечением сессий.

Шаг 1: перейдите на api.slack.com/apps и нажмите «Create New App». Выберите «From scratch», задайте имя приложения и выберите рабочее пространство (workspace), в которое оно будет установлено.

Шаг 2: в разделе «OAuth & Permissions» добавьте необходимые scope (разрешения). Минимально необходимые:

Bot Token Scopes:
- chat:write        # отправка сообщений
- channels:history  # чтение истории каналов
- channels:read     # просмотр списка каналов
- im:history        # чтение личных сообщений
- im:read           # доступ к личным сообщениям
- im:write          # отправка личных сообщений
- users:read        # информация о пользователях

Шаг 3: установите приложение в рабочее пространство. После установки вы получите Bot User OAuth Token (начинается с xoxb-). Скопируйте его.

Шаг 4: в разделе «Event Subscriptions» включите события и укажите URL для получения событий. Если OpenClaw доступен из интернета, укажите его URL напрямую. Если нет — используйте режим Socket Mode (в разделе «Socket Mode» включите его и получите App-Level Token).

Шаг 5: добавьте токены в конфигурацию OpenClaw:

channels:
  slack:
    enabled: true
    bot_token: ${SLACK_BOT_TOKEN}
    app_token: ${SLACK_APP_TOKEN}  # для Socket Mode
    socket_mode: true
    respond_in_thread: true
    allowed_channels:
      - "C01ABCDEF"  # ID разрешённых каналов
    allowed_users:
      - "U01GHIJKL"  # ID разрешённых пользователей

Параметр respond_in_thread: true заставляет бота отвечать в треде (ветке обсуждения), а не в основной ленте канала. Это рекомендуемый режим, чтобы не засорять канал ответами бота.

Особенности Slack-интеграции

Slack имеет ряд специфических возможностей. Бот может использовать Block Kit для форматированных ответов с кнопками, выпадающими списками и интерактивными элементами. В конфигурации это включается через параметр rich_formatting: true. Также бот может реагировать на эмодзи-реакции, slash-команды и shortcuts — все эти события настраиваются в разделе Event Subscriptions на api.slack.com.

Slack API имеет ограничения по частоте запросов (rate limits). Для большинства методов лимит составляет 1 запрос в секунду на метод. OpenClaw автоматически управляет rate limiting, ставя запросы в очередь при приближении к лимиту. Но при активном использовании в большом рабочем пространстве стоит мониторить логи на предмет предупреждений о throttling.

Discord: создание бота

Discord-интеграция настраивается через Discord Developer Portal. Процесс аналогичен Slack, но с некоторыми отличиями.

Шаг 1: перейдите на discord.com/developers/applications и создайте новое приложение. В разделе «Bot» нажмите «Add Bot».

Шаг 2: в настройках бота скопируйте Token. Включите опции «Message Content Intent» и «Server Members Intent» — без них бот не сможет читать содержимое сообщений.

Шаг 3: сгенерируйте ссылку для приглашения бота на сервер. В разделе «OAuth2 > URL Generator» выберите scope «bot» и необходимые разрешения (Send Messages, Read Message History, Add Reactions). Скопируйте сгенерированный URL и перейдите по нему, чтобы добавить бота на ваш Discord-сервер.

Шаг 4: настройте конфигурацию OpenClaw:

channels:
  discord:
    enabled: true
    token: ${DISCORD_BOT_TOKEN}
    allowed_guilds:
      - "123456789012345678"  # ID сервера
    allowed_channels:
      - "987654321098765432"  # ID канала
    respond_to_mentions: true
    respond_to_dms: true

Особенности Discord-интеграции

Discord отличается от Slack и Telegram в нескольких аспектах. Во-первых, Discord активно использует систему «намерений» (intents): бот должен явно запросить доступ к определённым типам событий. Без Message Content Intent бот видит сообщения, но их текст будет пустым — одна из частых причин, по которой интеграция «не работает».

Во-вторых, Discord поддерживает slash-команды (/commands) — интерактивные команды с автодополнением параметров. OpenClaw может автоматически регистрировать slash-команды для навыков (skills). Включите это в конфигурации:

channels:
  discord:
    slash_commands:
      enabled: true
      register_skills: true

В-третьих, Discord имеет лимит на длину сообщения — 2 000 символов. Если ответ агента длиннее, OpenClaw автоматически разбивает его на несколько сообщений. Для очень длинных ответов (например, сгенерированный код) используется формат embed или файл-вложение.

Мультиплатформенный режим

Настроив несколько каналов, вы получаете агента, доступного повсюду. Все каналы подключаются к одному Brain и разделяют общую память. Это значит, что агент помнит контекст разговора вне зависимости от платформы. Вы можете попросить агента в Slack «напомни мне об этом в Telegram в 18:00» — и он это сделает.

Конфигурация мультиканального режима не требует специальных настроек: просто включите все нужные каналы в config.yaml. OpenClaw автоматически маршрутизирует сообщения и ответы через соответствующие Gateway-модули. Единственное, что стоит настроить — это поведение уведомлений. По умолчанию агент отвечает в тот же канал, из которого пришёл запрос. Но вы можете переопределить это:

routing:
  default_response_channel: same  # отвечать в тот же канал
  notifications:
    urgent: telegram     # срочные — в Telegram
    work: slack           # рабочие — в Slack
    personal: whatsapp    # личные — в WhatsApp

Сравнение платформ

Каждая платформа имеет свои сильные и слабые стороны для AI-агента. WhatsApp — самый доступный мессенджер в мире, но интеграция через Web нестабильна, и бизнес-API дорог. Slack — идеален для рабочих задач, имеет мощный API и стабильное подключение, но доступен только тем, кто использует Slack. Discord — хорош для сообществ и персональных серверов, бесплатен и имеет богатый функционал ботов, но менее удобен для делового общения.

Рекомендуемая стратегия: используйте Telegram как основной канал (стабильный, бесплатный API, широкое распространение), Slack — для рабочих задач, если ваша компания его использует, и WhatsApp или Discord — как дополнительные каналы для специфических сценариев.

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

Наиболее частые проблемы при настройке каналов и их решения. Бот не отвечает: проверьте, что канал enabled: true, токены корректны, и ваш ID есть в allowed_users. Сообщения приходят с задержкой: переключитесь с polling на webhook (для Telegram и Slack). WhatsApp отключился: пересканируйте QR-код. Discord не видит текст сообщений: включите Message Content Intent в Developer Portal.

Для диагностики используйте команду:

openclaw status --channels

Она покажет состояние каждого подключённого канала: активен, отключён, ошибка подключения. Также полезна команда для просмотра последних событий по конкретному каналу:

openclaw logs --channel slack --last 50

Итог

Подключение нескольких каналов превращает OpenClaw в универсального ассистента, доступного на любой платформе. WhatsApp даёт мобильный доступ (но требует внимания к сессиям), Slack — профессиональную интеграцию с рабочим пространством, Discord — гибкость для персональных и общественных серверов. Настройка каждого канала занимает от пяти до пятнадцати минут. Главное — не забывать про безопасность: ограничивайте доступ, храните токены в переменных окружения и мониторьте состояние подключений.