Как подключить OpenClaw к Telegram

Коротко. Создайте бота через @BotFather в Telegram (/newbot) и скопируйте его токен. Передайте токен OpenClaw, а затем разрешите писать боту только своему числовому ID пользователя Telegram. На собственной машине это openclaw channels add --channel telegram --token <token> плюс dmPolicy: "allowlist" с вашим ID в allowFrom. На PlayNHost вы вставляете токен и свой ID на странице «Агент», и перезапускаете.

Проверено 6 ноября 2026, актуально для OpenClaw 2026.11.1.

В этом руководстве использована документация OpenClaw по Telegram и панель PlayNHost в её нынешнем виде. Telegram встроен в OpenClaw: плагин устанавливать не нужно.

Шаг 1: создайте бота и скопируйте его токен

1. В Telegram откройте чат с @BotFather. Убедитесь, что имя именно @BotFather.
2. Отправьте /newbot, выберите отображаемое имя, затем имя пользователя, оканчивающееся на bot.
3. BotFather ответит токеном, который выглядит так: 123456789:AAH.... Никому его не показывайте: любой, у кого он есть, может управлять вашим ботом.

У BotFather есть и веб-приложение (t.me/BotFather?startapp), которое делает то же самое кнопками.

Используйте бота, на котором больше ничего не запущено. Если старый OpenClaw на вашем ноутбуке или другая программа всё ещё использует тот же токен, сначала остановите её или создайте нового бота.

Шаг 2: найдите свой ID пользователя Telegram

Allowlist OpenClaw принимает ваш числовой ID пользователя, а не @имя пользователя, номер телефона или ID бота. Способы, которые перечисляет документация OpenClaw:

• От самого бота (без третьих лиц). Пока бот в режиме pairing, отправьте ему любое сообщение. В его ответе с pairing есть строка "Your Telegram user id". На PlayNHost мы советуем именно этот путь, см. ниже.
• Из лога OpenClaw. Запустите openclaw logs --follow, напишите боту и найдите senderUserId в записи telegram pairing request.
• Через API Telegram. Напишите боту, затем откройте https://api.telegram.org/bot<bot_token>/getUpdates и найдите message.from.id.
• Сторонний бот, например @userinfobot или @getidsbot. Документация OpenClaw считает это менее приватным.

Шаг 3 на PlayNHost: вставьте токен и свой ID

На той же странице нужен ключ ИИ-провайдера. Без него Start останавливается с сообщением "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token."

1. Откройте свой сервер на panel.playnhost.com, затем вкладку Агент.
2. В разделе ИИ-провайдер задайте один ключ, если его ещё нет (см. какой ключ ИИ-провайдера использовать).
3. В разделе Чат-приложения нажмите Задать у пункта Токен бота Telegram, вставьте токен от BotFather и нажмите Сохранить. Панель проверяет его формат; при неверной вставке она выдаёт "That is not a valid telegram bot token." После сохранения в строке видны только последние четыре символа, а токен больше не показывается.
4. Ещё не знаете свой ID? Оставьте поле ID пользователей Telegram пустым и нажмите Запустить. Когда агент запустится, консоль выведет:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: it answers with your Telegram user ID. Copy that ID, put it on the Agent page, then restart. Ignore the pairing code in its reply.

   Напишите своему боту в Telegram. Он один раз ответит кодом pairing и вашим ID пользователя Telegram (OpenClaw присылает код примерно раз в час на человека и игнорирует сообщения между ними). Скопируйте ID и игнорируйте код: на PlayNHost ничего подтверждать не нужно. Этот шаг никого не пускает.
5. В разделе Кто может ему писать введите свой ID в поле ID пользователей Telegram и нажмите Сохранить. Несколько ID пишутся в одну строку через запятую.
6. Страница сообщает: "Изменения применятся при следующем запуске вашего агента." Нажмите Перезапустить сейчас. Затем консоль подтвердит:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Напишите своему боту. Агент ответит. Сообщения с любых других аккаунтов Telegram игнорируются.

Что PlayNHost настраивает за вас

• Когда на панели Агент есть ID, личные сообщения в Telegram используют dmPolicy: "allowlist" ровно с этими ID, что и рекомендует документация OpenClaw для бота с одним владельцем. Без ID используется pairing: посторонние получают код и игнорируются, а подтвердить их без командной строки или дашборда OpenClaw никто не может, и ни того ни другого сервер PlayNHost не предлагает.
• Перечисленные вами ID становятся также владельцами команд OpenClaw (commands.ownerAllowFrom), поэтому команды только для владельца работают у вас с первого сообщения.
• Токен попадает в OpenClaw как TELEGRAM_BOT_TOKEN в его окружении. Токен, записанный в собственный файл настроек OpenClaw, имел бы приоритет, поэтому старт удаляет его из файла: используется токен с панели Агент.
• Группы остаются закрытыми: OpenClaw не допускает ни одну группу, пока её не добавят в его настройки, а параметр, разрешающий писать агенту всем, при следующем старте возвращается к вашим ID.

Шаг 3 на собственной машине

1. Добавьте токен:

   openclaw channels add --channel telegram --token <bot-token>

   или задайте TELEGRAM_BOT_TOKEN в окружении Gateway. Токен в файле конфигурации приоритетнее переменной окружения.
2. Разрешите писать только себе в ~/.openclaw/openclaw.json:

   {
     channels: {
       telegram: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["123456789"],
       },
     },
     commands: {
       ownerAllowFrom: ["telegram:123456789"],
     },
   }

   Часть commands делает вас владельцем для команд только для владельца: для вручную написанного allowlist OpenClaw этого не делает. allowlist с пустым allowFrom блокирует все личные сообщения и отклоняется проверкой конфигурации OpenClaw.
3. Или оставьте режим pairing по умолчанию и подтвердите себя после первого сообщения:

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   Коды истекают через час. Первое подтверждённое pairing также делает вас владельцем команд.
4. Проверьте канал командой openclaw channels status --probe.

Если бот не отвечает

Хотите добавить и Discord? См. как подключить OpenClaw к Discord. Ещё не настроили? Создайте сервер OpenClaw.

PlayNHost не связан с OpenClaw Foundation. OpenClaw это программное обеспечение с открытым кодом под лицензией MIT.