Управляй AI-агентом с телефона через Telegram

В чём фокус

Это не облачный сервис и не очередная подписка. Это твой собственный AI-агент, который живёт на твоём компьютере, а Telegram служит ему пультом. Схема стала виральной после ролика trakin.ai, и она правда работает: бот в Telegram принимает твои сообщения, агент на ПК их исполняет — у него есть доступ к файлам, терминалу и браузеру.

Ключевое отличие от «спросить ChatGPT с телефона»: облачный чат ничего не знает про твои файлы и не может запустить сборку твоего проекта. Агент на твоей машине — может. Телефон здесь только клиент: ставишь задачу и принимаешь результат, а вся работа происходит там, где лежат твои проекты.

Идея в одну строку: телефон — для постановки задачи и приёмки результата, компьютер — для исполнения. Telegram между ними — просто провод.

Как это устроено

Механика проще, чем кажется. Telegram-бот сам по себе ничего не умеет: это просто почтовый ящик с API. Вся работа происходит на твоём компьютере, где крутится агент. Он опрашивает серверы Telegram, забирает твои сообщения, выполняет задачу локально и отправляет ответ обратно.

У такой архитектуры есть приятный побочный эффект: не нужно открывать порты, покупать статический IP или настраивать туннели. Агент сам ходит к Telegram, а не наоборот, — значит, снаружи к твоему компьютеру никто не подключается. Из этого следует и главное правило: компьютер должен быть включён, а агент запущен. Выключил ноутбук — пульт перестал работать.

Какой агент выбрать

Я проверил, что реально существует и документировано, а не пересказано по слухам. Живых варианта три.

Hermes Agent от Nous Research

Open-source агент с официальным Telegram-гейтвеем. Настройка честная и предсказуемая: токен бота плюс allowlist по числовому user id, гейтвей по умолчанию отклоняет всех, кто не в списке. Есть отдельные настройки для групповых чатов и туториал про командного ассистента. Бери его, если хочешь один инструмент «агент + мессенджер» из коробки.

OpenClaw (экс-Moltbot/Clawdbot)

Персональный ассистент-комбайн: кроме Telegram подключается к WhatsApp, Discord, Slack, Signal и ещё десяткам каналов, поддерживает разные модели — Claude, GPT, Gemini, DeepSeek. Безопасность решена через pairing: незнакомец получает код подключения, и бот молчит, пока ты не одобришь код. Выбирай, если хочешь одного ассистента сразу на несколько мессенджеров.

Мост к Claude Code

Если уже работаешь в Claude Code, можно не заводить отдельного агента, а прокинуть к нему Telegram-мост. Это самый короткий путь для разработчика: та же сессия, те же проекты — только теперь из кармана.

Документация Hermes лежит в репозитории NousResearch/hermes-agent и в официальных доках по Telegram, плюс есть туториал про командного Telegram-ассистента. OpenClaw живёт в репозитории openclaw/openclaw.

Практический совет: для первого запуска бери Hermes — у него самый прозрачный сетап. OpenClaw богаче, но и настроек больше.

Сетап Hermes по шагам

Покажу на примере Hermes; для остальных агентов меняются только шаги с подключением токена, а логика та же. Первые два шага общие для любого варианта.

Шаг 1. Создай бота у BotFather

Открой Telegram, найди официального @BotFather, отправь /newbot. Он спросит отображаемое имя (любое) и юзернейм, который обязан заканчиваться на bot — например denis_agent_bot. В ответ придёт access token вида 123456789:ABCdef.... Скопируй его и никому не показывай: этот токен — полный доступ к боту.

Шаг 2. Узнай свой user id

Напиши боту @userinfobot — он мгновенно ответит твоим числовым id, например 123456789. Важно: нужен именно числовой id, а не @юзернейм. Юзернейм можно сменить, числовой id постоянный, поэтому allowlist строится только на нём.

Шаг 3. Подключи токен к агенту

У Hermes есть интерактивный мастер:

▸терминал · мастер настройки

hermes gateway setup

Выбираешь Telegram, вставляешь токен и свой user id. Либо вручную в файл ~/.hermes/.env:

▸~/.hermes/.env

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Шаг 4. Запусти гейтвей

▸терминал · запуск

hermes gateway

Терминал можно свернуть, главное — не выключать компьютер.

Шаг 5. Проверь с телефона

Открой своего бота в Telegram и напиши что-нибудь простое: «покажи список файлов на рабочем столе». Пришёл ответ — всё работает. Бот молчит — первым делом проверь, что твой id действительно в TELEGRAM_ALLOWED_USERS.

Сетап OpenClaw по шагам

Бот у BotFather и числовой user id нужны те же самые (шаги 1–2 выше). Дальше OpenClaw ведёт через собственный мастер.

Шаг 1. Установи и запусти онбординг

▸терминал · установка и мастер

npm install -g openclaw@latest
openclaw onboard --install-daemon

Мастер сам проведёт через подключение Telegram: вставляешь токен бота, а флаг --install-daemon ставит агента как фоновый сервис — отдельный терминал держать не нужно.

Шаг 2. Одобри себя через pairing

Вместо allowlist в конфиге OpenClaw использует pairing: когда боту пишет незнакомый отправитель, тот получает код подключения, и бот не обрабатывает его сообщения, пока ты не одобришь код с компьютера:

▸терминал · одобрение отправителя

openclaw pairing approve <код из чата>

Шаг 3. Проверь конфигурацию

▸терминал · самодиагностика

openclaw doctor

Команда прогоняет конфигурацию по чек-листу и показывает, что настроено неправильно. После неё — тот же тест с телефона: простое сообщение боту и проверка, что незнакомый аккаунт ответа не получает.

Мосты Claude Code ↔ Telegram

Третий путь — для тех, кто уже живёт в Claude Code. Отдельный агент не нужен: мост подключает Telegram-бота напрямую к твоей сессии Claude Code, и ты продолжаешь работу в тех же проектах, только из чата. Живых моста три:

terranc/claude-telegram-bot-bridge — базовый мост: сообщения из Telegram уходят в Claude Code, ответы возвращаются в чат.
RichardAtCT/claude-code-telegram — альтернативная реализация той же идеи.
jsayubi/ccgram — умеет присылать кнопки подтверждения, когда Claude просит разрешение на действие: жмёшь «разрешить» прямо в Telegram, не подходя к компьютеру.

Схема подключения у всех одна: тот же токен от BotFather, тот же числовой id в настройках доступа — и Claude Code у тебя в кармане. Именно так делаются мелкие правки кода из очереди в поликлинике: та же сессия, те же файлы, тот же CLAUDE.md с правилами проекта.

Безопасность: это не игрушка

Здесь стоит притормозить. Агент имеет доступ к твоему компьютеру: файлы, терминал, браузер. Тот, кто может писать боту, фактически сидит за твоей клавиатурой. Поэтому три правила без исключений.

Allowlist обязателен — и его надо проверить

У Hermes гейтвей по умолчанию отклоняет всех, но был issue о том, что при неверной настройке доступ мог оказаться открытым. Поэтому после установки напиши боту с чужого аккаунта и убедись, что он не отвечает. У OpenClaw для проверки конфигурации есть команда openclaw doctor.

Токен не светить

Не коммить его в git, не кидать скриншотом в чат, не вставлять в публичные конфиги. Утёк? Иди к BotFather, команда /revoke — получишь новый токен, обновишь конфиг. Занимает минуту.

Входящие сообщения — недоверенный ввод

Документация OpenClaw прямо предупреждает: по умолчанию инструменты главной сессии работают с полным доступом к хосту. Поэтому в группы такого бота лучше не добавлять вовсе, а держать в личке один на один.

Тот самый случай с Hermes задокументирован в issue #24457 — не паранойя, а причина потратить две минуты на проверку с чужого аккаунта.

Пять задач, которые я даю агенту с телефона

Чтобы было понятно, зачем это всё, — реальные сценарии, а не абстракции.

«Проверь, собрался ли проект, и пришли лог ошибок»

Агент запускает сборку в терминале и присылает выжимку. Экономит поход к компьютеру ради двух строчек лога.

«Найди в Downloads все PDF за неделю и разложи по папкам с названием отправителя»

Рутинная уборка файлов, которую вечно откладываешь.

«Спарси цены с этих трёх страниц и сведи в таблицу»

Агент откроет страницы, вытащит данные, сохранит CSV и пришлёт файл прямо в чат.

«Допиши в скрипт обработку ошибки и закоммить в отдельную ветку»

Мелкие правки кода из очереди в поликлинике: мост к Claude Code делает это в твоём же проекте.

«Каждый вечер присылай сводку: что изменилось в репозитории и какие файлы я трогал»

Агент превращается в ассистента, который отчитывается сам, без напоминаний.

Общий паттерн: телефон для постановки задачи и приёмки результата, компьютер для исполнения. Через неделю такой связки перестаёшь понимать, как жил без неё.

◆ от пульта — к заводу

Агент в кармане есть. А что ему поручать, чтобы это приносило деньги?

Telegram-пульт — это способ управлять. Дальше идёт система: контент пачками, воронки на кодовые слова, лид-магниты и платёжки — всё это собирается тем же агентом на Claude Code. Целиком эту машину разбираем на практикуме, по шагам.

Что за практикум →

Зачем тебе это на самом деле

Сетап выше занимает 15 минут, а меняет он не скорость, а саму рамку. Раньше задачи существовали, только пока ты сидишь за компьютером: отошёл — работа встала, мысль «надо бы сделать» умерла в очереди или в машине. С пультом в Telegram компьютер продолжает работать без тебя, а ты ставишь задачи в тот момент, когда они пришли в голову.

По сути это первый шаг от «я работаю с ИИ» к «у меня работает ИИ»: агент исполняет, отчитывается и присылает результат сам, а тебе остаётся роль того, кто ставит задачи и принимает работу.