Каналы OpenClaw: Telegram, WhatsApp, Discord — настройка на русском

Одно из главных преимуществ OpenClaw — возможность общаться с AI-агентом через привычные мессенджеры. Вместо того чтобы открывать отдельное приложение или веб-интерфейс, вы пишете боту прямо в Telegram, WhatsApp или Discord, и он выполняет ваши задачи. В этой статье мы разберём настройку трёх самых популярных каналов.

Общие принципы конфигурации описаны в справочнике настроек. Если вы ещё не установили OpenClaw — начните с быстрого старта.

Telegram: настройка бота

Telegram — самый простой и популярный канал для OpenClaw в России. Используется Bot API через библиотеку grammY. Режим по умолчанию — long polling (постоянное соединение).

Пошаговая настройка

1. Создайте бота через @BotFather — откройте Telegram, найдите @BotFather (убедитесь, что это официальный бот), отправьте /newbot, следуйте инструкциям и сохраните полученный токен
2. Добавьте токен в конфигурацию:

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123456:ABC-DEF...",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } },
    },
  },
}

3. Запустите Gateway и одобрите первое сообщение:

openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

Коды подтверждения действуют 1 час.

Настройки на стороне Telegram

Privacy Mode: По умолчанию боты в Telegram не видят все сообщения в группах. Чтобы бот получал все сообщения, либо отключите Privacy Mode через /setprivacy у @BotFather, либо сделайте бота администратором группы.

Полезные команды BotFather:

• /setjoingroups — разрешить/запретить добавление бота в группы
• /setprivacy — управление видимостью сообщений в группах

Как узнать свой Telegram ID

1. Напишите своему боту любое сообщение
2. Выполните openclaw logs --follow
3. Найдите поле from.id в логах

Стриминг ответов (предпросмотр)

OpenClaw может показывать ответ в реальном времени, редактируя временное сообщение по мере генерации текста. Режимы streamMode:

• off — без предпросмотра
• partial (по умолчанию) — частые обновления
• block — обновления блоками

WhatsApp: настройка через WhatsApp Web

WhatsApp в OpenClaw работает через WhatsApp Web (библиотека Baileys). Gateway управляет связанной сессией.

Пошаговая настройка

1. Настройте политику доступа:

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+79001234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+79001234567"],
    },
  },
}

2. Привяжите WhatsApp (QR-код):

openclaw channels login --channel whatsapp

3. Запустите Gateway:

openclaw gateway

Особенности WhatsApp

• Уведомления о прочтении — включены по умолчанию, можно отключить через sendReadReceipts: false
• Чанкинг текста — длинные ответы автоматически делятся на части (лимит по умолчанию 4000 символов)
• Медиафайлы — поддержка изображений, видео, голосовых сообщений и документов
• История группы — при первом вызове в группе бот получает контекст последних 50 сообщений

Discord: настройка бота

Discord подключается через официальный Discord Gateway с поддержкой ЛС и серверных каналов.

Пошаговая настройка

1. Создайте приложение в Discord Developer Portal, добавьте бота, включите:

• Message Content Intent
• Server Members Intent (для ролевых списков доступа)

2. Добавьте токен в конфигурацию:

{
  channels: {
    discord: {
      enabled: true,
      token: "YOUR_BOT_TOKEN",
    },
  },
}

3. Пригласите бота на сервер с нужными разрешениями и запустите Gateway

Интерактивные компоненты Discord

OpenClaw поддерживает Discord Components v2 — кнопки, выпадающие списки, модальные формы. Это позволяет создавать интерактивные интерфейсы прямо в чате:

• Кнопки с разными стилями (success, danger, primary)
• Выпадающие списки (select) — строковые, по пользователям, ролям, каналам
• Модальные формы с полями ввода
• Ограничение доступа к кнопкам по ID пользователя

Маршрутизация по ролям

Уникальная возможность Discord — маршрутизация пользователей к разным агентам на основе ролей сервера:

{
  bindings: [
    {
      agentId: "opus",
      match: {
        channel: "discord",
        guildId: "123456789",
        roles: ["111111111"],
      },
    },
    {
      agentId: "sonnet",
      match: {
        channel: "discord",
        guildId: "123456789",
      },
    },
  ],
}

Общие принципы для всех каналов

Политика доступа к ЛС (dmPolicy)

Все каналы поддерживают четыре режима:

• pairing — незнакомые отправители получают код подтверждения (по умолчанию)
• allowlist — только пользователи из белого списка
• open — открытый доступ (требует allowFrom: ["*"])
• disabled — ЛС отключены

Управление группами

Для групп есть два уровня контроля:

1. Какие группы разрешены — через groups (белый список групп)
2. Кто может писать в группах — через groupPolicy + groupAllowFrom

Упоминания (mention gating)

По умолчанию бот отвечает в группах только при упоминании. Можно использовать:

• Нативное @-упоминание
• Регулярные выражения в mentionPatterns
• Команды /activation always и /activation mention для управления на лету

Другие поддерживаемые каналы

Помимо трёх основных, OpenClaw поддерживает:

• Slack — через Slack Bot API
• Signal — через Signal CLI
• iMessage — нативная интеграция на macOS
• Google Chat — через Google Workspace API
• Mattermost — через плагин
• Microsoft Teams — через Bot Framework