Подключение OpenClaw к Telegram-боту: пошаговый мануал

OpenClaw (Claw bot / Moltbot) можно использовать как Telegram-бота: пользователи пишут ему в личку или в группу, агент отвечает, выполняет скиллы (поиск, файлы, задачи и т.д.). Подключение занимает несколько минут: создать бота в BotFather, прописать токен в конфиг и запустить gateway. В этом мануале — пошаговая настройка подключения OpenClaw к Telegram-боту: от токена до личных чатов и групп.

Что понадобится

• Установленный OpenClaw (через npm install -g openclaw или официальный установщик).
• Аккаунт в Telegram и возможность писать @BotFather.
• Файл конфигурации: ~/.openclaw/openclaw.json (или config.json5 — в зависимости от версии).

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

• Откройте Telegram и найдите @BotFather (проверьте, что это именно официальный бот).
• Отправьте команду /newbot.
• Введите имя бота (например, «Мой OpenClaw») и username (должен заканчиваться на bot, например my_openclaw_bot).
• BotFather пришлёт токен в формате 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Сохраните его — он понадобится для конфига.

Шаг 2. Узнать свой Telegram User ID (для личных сообщений)

• Пропишите токен в конфиг и запустите gateway (см. ниже).
• В другом терминале: openclaw logs --follow.
• Напишите боту в личку любое сообщение.
• В логах появится поле from.id — это ваш user ID (число, например 8734062810).

curl "https://api.telegram.org/bot<ВАШ_ТОКЕН>/getUpdates"

Шаг 3. Настройка конфигурации OpenClaw

• Linux/macOS: ~/.openclaw/openclaw.json или ~/.openclaw/config.json5
• Windows: %USERPROFILE%\.openclaw\openclaw.json

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrSTUvwxYZ",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

• enabled: true — канал Telegram включён.
• botToken — токен от BotFather. Можно вынести в переменную окружения TELEGRAM_BOT_TOKEN и не хранить в файле.
• dmPolicy — кто может писать боту в личку:

• groups["*"].requireMention: true — в группах бот реагирует только когда его упоминают (@username_бота). Так бот не будет отвечать на каждое сообщение в чате.

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "ВАШ_ТОКЕН",
      "dmPolicy": "allowlist",
      "allowFrom": ["8734062810"]
    }
  }
}

Шаг 4. Запуск gateway и одобрение доступа (при dmPolicy: pairing)

• Запустите шлюз OpenClaw:

openclaw gateway

openclaw gateway --port 18789

• Когда новый пользователь впервые напишет боту в личку, он получит код подтверждения (pairing code). Вы должны одобрить его вручную.

openclaw pairing list telegram

openclaw pairing approve telegram ABCD1234

• Напишите боту в Telegram — он должен ответить (если модель и скиллы настроены).

Шаг 5. Бот в группах

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

• Создайте группу или откройте существующую.
• Добавьте бота в участники (через «Добавить участника» → поиск по username бота).
• Если бот не видит сообщения в группе — включите режим конфиденциальности в BotFather:

Реакция только на упоминание

Разрешить одну конкретную группу

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "ВАШ_ТОКЕН",
      "dmPolicy": "pairing",
      "groups": {
        "-1001234567890": {
          "requireMention": true
        }
      }
    }
  }
}

Типичные проблемы