Урок 1: Подключение Telegram

Чему вы научитесь

• Создавать Telegram-бота через @BotFather
• Подключать бота к OpenClaw через конфигурационный файл
• Настраивать политику личных сообщений (DM)
• Настраивать работу в групповых чатах
• Управлять доступом: кто может писать боту

Почему Telegram

Telegram — самый удобный канал для начала работы с OpenClaw:

• Быстрое создание бота (5 минут через @BotFather)
• Не нужен телефонный номер для бота
• Поддержка файлов, изображений, голосовых сообщений
• Групповые чаты с гибкой активацией
• Стабильный API, без ограничений на количество сообщений

Шаг 1. Создание бота в Telegram

1. Откройте Telegram и найдите бота @BotFather.

2. Отправьте команду /newbot.

3. BotFather спросит имя бота. Введите человекочитаемое имя:

My AI Assistant

4. Затем введите username бота (должен заканчиваться на bot):

my_ai_helper_bot

5. BotFather выдаст токен — длинную строку вида:

7123456789:AAH1bGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9

Сохраните этот токен — он понадобится на следующем шаге.

Дополнительные настройки BotFather

Рекомендуем сразу настроить бота:

/setdescription -- описание бота (видно при первом открытии)
/setabouttext   -- краткое описание в профиле
/setuserpic     -- аватарка бота
/setcommands    -- список команд (можно пропустить)

Для работы в групповых чатах отключите Privacy Mode:

/mybots → выберите бота → Bot Settings → Group Privacy → Turn off

Отключение Privacy Mode позволяет боту видеть все сообщения в группе, а не только те, которые начинаются с / или упоминают бота.

Шаг 2. Подключение к OpenClaw

Добавьте токен бота в конфигурационный файл ~/.openclaw/openclaw.json (или используйте переменную окружения TELEGRAM_BOT_TOKEN=...) и запустите openclaw gateway.

Отредактируйте файл ~/.openclaw/openclaw.json и добавьте секцию с botToken:

{
  "channels": {
    "telegram": {
      "botToken": "7123456789:AAH1bGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9"
    }
  }
}

Затем запустите:

openclaw gateway

Шаг 3. Проверка

Откройте Telegram, найдите вашего бота и отправьте сообщение:

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

Если всё настроено правильно, бот ответит. Время ответа зависит от выбранной AI-модели (обычно 2-5 секунд).

Проверьте статус канала:

openclaw channels status --channel telegram

Channel: telegram
  Status: connected
  Bot: @my_ai_helper_bot
  Bot ID: 7123456789
  DM Policy: pairing
  Active sessions: 0

Настройка: политика личных сообщений

По умолчанию бот отвечает всем, кто ему пишет. Это можно ограничить.

Открытый доступ (по умолчанию)

Любой пользователь может писать боту:

{
  "channels": {
    "telegram": {
      "botToken": "7123456789:AAH...",
      "dmPolicy": "open"
    }
  }
}

Ограниченный доступ

Только указанные пользователи могут писать:

{
  "channels": {
    "telegram": {
      "botToken": "7123456789:AAH...",
      "dmPolicy": "allowlist",
      "allowFrom": [
        123456789,
        987654321
      ]
    }
  }
}

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

Отправьте боту команду /status — в ответе будет ваш user ID. Или используйте бота @userinfobot.

Рекомендация

Если вы не планируете делать бота публичным, установите dmPolicy: "allowlist" и добавьте только свой ID. Это предотвратит нежелательное использование вашего API-ключа другими людьми.

Групповые чаты

OpenClaw может работать в групповых чатах Telegram. Это полезно для семейных, рабочих или тематических групп.

Добавление бота в группу

1. Откройте групповой чат в Telegram.
2. Нажмите на название группы -> “Добавить участника”.
3. Найдите вашего бота по username и добавьте.

Режимы активации

В группе бот может реагировать по-разному:

Режим mention (по умолчанию): бот отвечает только когда его упоминают:

@my_ai_helper_bot Какая погода в Москве?

Режим always: бот отвечает на каждое сообщение в группе:

{
  "channels": {
    "telegram": {
      "groups": {
        "*": { "requireMention": false }
      }
    }
  }
}

Режим keyword: для реакции на ключевые слова используйте навыки (skills) или настройте через plugins. Базовая активация в группе — через requireMention: false.

Рекомендации для групповых чатов

• В рабочих группах используйте requireMention: true — бот не будет мешать обсуждениям
• В семейных группах можно настроить реакцию на слова через skills/plugins
• requireMention: false подходит только для групп, специально созданных для общения с ботом

Расширенная конфигурация

Полный пример конфигурации Telegram-канала

{
  "channels": {
    "telegram": {
      // Обязательно
      "botToken": "7123456789:AAH...",

      // Политика личных сообщений
      "dmPolicy": "allowlist",
      "allowFrom": [123456789],

      // Групповые чаты
      "groups": {
        "*": { "requireMention": true }
      },
      "groupPolicy": "allowlist",
      "allowGroups": ["-1001234567890"],  // ID разрешённых групп

      // Дополнительно
      "parseMode": "Markdown",           // формат ответов
      "maxMessageLength": 4096,          // лимит Telegram API
      "splitLongMessages": true          // разбивать длинные ответы
    }
  }
}

Несколько Telegram-ботов

OpenClaw поддерживает несколько Telegram-ботов одновременно. Это полезно для мультиагентной архитектуры (подробнее в Модуле 3.4):

{
  "channels": {
    "telegram": {
      "botToken": "7123456789:AAH...",
      // Личный бот
    },
    "telegram:work": {
      "botToken": "9876543210:BBK...",
      // Рабочий бот
    }
  }
}

Устранение проблем

Бот не отвечает

1. Проверьте статус Gateway: openclaw status
2. Проверьте статус канала: openclaw channels status --channel telegram
3. Посмотрите логи: openclaw logs -f и отправьте сообщение боту
4. Убедитесь, что токен правильный: openclaw config get channels.telegram.botToken

Бот отвечает медленно

• Проверьте модель: большие модели (Opus) отвечают дольше
• Проверьте сетевое соединение с API-провайдером
• Убедитесь, что Gateway не перегружен: openclaw status

Бот не видит сообщения в группе

• Убедитесь, что Privacy Mode отключён (через @BotFather)
• Проверьте, что группа добавлена в allowGroups (если используете)
• Проверьте режим активации: в mention бот ждёт упоминания

Попробуйте сами

1. Создайте бота через @BotFather и подключите к OpenClaw.

2. Проверьте работу — отправьте 5 сообщений:

   • Простой вопрос
   • Просьба перевести текст
   • Просьба проанализировать ссылку
   • Отправка файла (фото или документ)
   • Команда /status

3. Настройте доступ — установите dmPolicy: "allowlist" и добавьте свой ID.

4. Попробуйте группу — добавьте бота в тестовую группу, проверьте режим mention.

Ключевые выводы

• Подключение Telegram занимает 5-10 минут: создать бота через @BotFather, добавить токен в ~/.openclaw/openclaw.json и запустить openclaw gateway
• Политика DM контролирует, кто может писать боту: open, allowlist, pairing или disabled
• В групповых чатах активация настраивается через requireMention (true/false) и groupPolicy
• Рекомендуется ограничить доступ через allowlist, чтобы не тратить API-ключ на чужие запросы
• OpenClaw поддерживает несколько Telegram-ботов для разных агентов

Следующий урок

Урок 2: Подключение WhatsApp — подключим WhatsApp без официального API через библиотеку Baileys.