Telegram для CLI-агентов

Codex, Claude Code, Hermes Agent и OpenClaw можно связать с личным Telegram-ботом. После настройки вы сможете отправлять агенту задачи из Telegram, а модельные запросы продолжат идти через Promto и учитываться в нейробалансе рабочего стола.

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

1. Включите Настройки → Функции → Показывать терминал.
2. Нажмите Новый → Сессия в терминале и запустите нужного агента.
3. Создайте личного бота через @BotFather:

• отправьте /newbot;
• задайте имя и username;
• сохраните выданный bot token.

1. Выполните инструкцию для выбранного агента ниже.

Bot token выглядит как длинная строка с двоеточием. Это секрет: не добавляйте его в файлы проекта, сообщения обычного чата, скриншоты или Git. Вводите token только в указанную команду настройки.

Быстрый выбор

Агент	Где настраивается	Как ограничивается доступ
OpenClaw	В shell командой openclaw channels add	Нативный pairing OpenClaw
Claude Code	В Claude Code командой /telegram:configure	Pairing и allowlist официального plugin
Hermes Agent	В мастере hermes gateway setup	Список разрешённых Telegram user ID
Codex	В Codex через !promto-codex-telegram	Pairing и allowlist Promto-адаптера

OpenClaw

OpenClaw использует собственный Telegram channel и нативный Gateway.

1. Выйдите из OpenClaw TUI в shell этой терминальной вкладки.
2. Сохраните token:

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

1. Снова запустите OpenClaw.
2. Откройте созданного бота в Telegram и отправьте ему любое сообщение.
3. Вернитесь в shell и подтвердите пользователя:

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

1. Проверьте канал:

openclaw channels status

Для Telegram не используется openclaw channels login telegram: достаточно добавить token и пройти pairing. Удалить канал можно командой:

openclaw channels remove --channel telegram --delete

Claude Code

Promto автоматически подготавливает официальный Telegram plugin Claude Code. Устанавливать его вручную не нужно.

1. Введите внутри Claude Code:

/telegram:configure <bot-token>

1. Выйдите из Claude Code и запустите его снова. Канал подключается при новом запуске.
2. Напишите созданному боту в Telegram. Он пришлёт код pairing.
3. Вернитесь в Claude Code и выполните:

/telegram:access pair <CODE>
/telegram:access policy allowlist

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

Hermes Agent

Hermes использует собственный messaging Gateway. Для настройки понадобится числовой Telegram user ID — его можно узнать, например, у @userinfobot.

1. Выйдите из Hermes TUI в shell этой терминальной вкладки.
2. Запустите мастер:

hermes gateway setup

1. Выберите Telegram, вставьте bot token и укажите разрешённые числовые user ID.
2. Снова запустите Hermes.
3. Напишите боту в Telegram и убедитесь, что он отвечает.

После сохранения token Promto автоматически запускает Hermes Gateway рядом с TUI. Вручную поднимать systemd-сервис не нужно. Если в Hermes уже настроен home channel, текущий диалог можно передать в Telegram нативной командой:

/handoff telegram

Codex

У Codex CLI нет собственного Telegram channel, поэтому Promto добавляет совместимый адаптер. Команды ниже вводятся прямо внутри Codex: символ ! запускает их в shell текущей сессии.

1. Сохраните token:

!promto-codex-telegram configure <bot-token>

1. Выйдите из Codex и запустите его снова.
2. Напишите боту в Telegram. Он вернёт код из шести букв и цифр.
3. Подтвердите код внутри Codex:

!promto-codex-telegram pair <CODE>

1. Проверьте состояние без вывода token:

!promto-codex-telegram status

Каждый разрешённый Telegram-диалог получает отдельную сохраняемую Codex thread. Команда /new в Telegram начинает новую thread, а /status показывает состояние канала.

Как долго работает бот

Telegram-канал живёт вместе с физической терминальной сессией:

• переключение на другое приложение или обычная перезагрузка страницы не останавливают живой PTY;
• закрытие терминальной вкладки завершает агента и его Telegram runtime;
• после сна или перезапуска рабочего стола бот будет офлайн, пока соответствующая терминальная сессия не восстановится или агент не будет запущен снова;
• сохранённые token, allowlist и pairing остаются в приватной конфигурации агента внутри рабочего стола.

Это удобный удалённый доступ к текущему CLI-агенту, но не круглосуточный hosting бота.

Оплата и безопасность

• BotFather token авторизует только Telegram-бота и не оплачивает модель.
• Codex, Claude Code, Hermes и OpenClaw продолжают обращаться к моделям через Promto; отдельный OpenAI, Anthropic или OpenRouter API key не требуется.
• Расход учитывается в нейробалансе рабочего стола так же, как при работе из терминала.
• Если нейробаланс закончился, Telegram-канал останется настроенным, но новые модельные ответы не выполнятся до пополнения.
• Pairing или список разрешённых user ID не дают посторонним писать агенту.
• Сетевой маршрут до Telegram применяется средой автоматически. Не добавляйте собственные proxy-переменные и не меняйте системную сеть.

Если token случайно попал в сообщение, файл или скриншот, отзовите его через BotFather, получите новый и повторите настройку.

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

Бот молчит сразу после настройки. Перезапустите выбранный CLI: Telegram runtime подключается при старте агента. Убедитесь, что терминальная вкладка остаётся активной.

Telegram сообщает о конфликте запросов. Один и тот же bot token запущен в двух терминалах или агентах. Остановите лишний runtime либо создайте второго бота.

Pairing code не принимается. Отправьте боту новое сообщение и подтвердите свежий код. Коды действуют ограниченное время.

OpenClaw не видит канал. Выполните openclaw channels status, затем проверьте pairing через openclaw pairing list telegram.

Hermes не отвечает конкретному пользователю. Повторите hermes gateway setup и проверьте числовой user ID в allowlist.

Codex настроен, но bridge не запустился. Проверьте !promto-codex-telegram status, затем полностью перезапустите Codex.

Инструкции и CLI для агента

CLI-агент может проверить состояние своего Telegram-канала, но не должен печатать bot token, содержимое секретных файлов или менять allowlist без явного разрешения. Для общей информации о среде сначала используйте:

promto instructions

Готовый промпт для CLI-агента

Проверь, настроен ли Telegram-канал текущего агента и запущен ли его runtime. Не показывай bot token, секретные файлы и другие credentials. Ничего не перенастраивай и не меняй allowlist. Сообщи: какой канал обнаружен, активен ли процесс, разрешён ли мой пользователь и какую безопасную проверку мне выполнить из Telegram.

Связанные статьи

• Терминал и терминальные агенты
• Codex в терминале
• Hermes Agent в терминале
• OpenClaw в терминале
• Telegram рабочего пространства