Как подключить Hermes Agent к Telegram и управлять задачами с телефона

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

Если самого Hermes у тебя ещё нет, начни с разбора что это за агент и как его установить, а затем возвращайся к подключению Telegram.

В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись, чтобы быть в курсе.

Что нужно для подключения Hermes Agent к Telegram?

Команда hermes doctor проверит установку Hermes и подключение модели. Бота будем создавать в приложении Telegram, а компьютер понадобится для команд в терминале.

Как создать бота через BotFather?

У каждого Telegram-бота есть токен - секретный ключ для управления ботом. Выдаёт его официальный бот Telegram по имени @BotFather.

1. Открой @BotFather

   Набери в поиске Telegram @BotFather или открой ссылку t.me/BotFather. У настоящего BotFather синяя галочка верификации. Запусти диалог кнопкой «Start».

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

   BotFather спросит два названия. Первое - отображаемое имя, оно может быть любым, например «Мой агент». Второе - юзернейм: он должен быть уникальным, и в конце должно стоять bot, например moy_agent_bot.

3. Забери токен

   BotFather ответит поздравлением и длинной строкой вида 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Это токен бота. Скопируй его целиком.

Есть и быстрый путь без ручного диалога с BotFather. В веб-панели Hermes (hermes dashboard) и в десктоп-приложении на странице «Messaging → Telegram» есть кнопка «Create with QR»: сканируешь код телефоном, и Hermes создаёт бота, определяет твой ID, записывает токен в настройки и перезапускает шлюз. Дальше по шагам разбираю ручной путь; если выбрал QR, переходи сразу к проверке подключения.

Как узнать свой ID в Telegram и зачем он нужен?

У аккаунта в Telegram есть два идентификатора: публичный юзернейм с собачкой и внутренний числовой ID. Hermes работает с числом.

Узнать своё число просто: открой @userinfobot, нажми «Start», и он ответит тебе твоим ID. Запиши его рядом с токеном. Запасной вариант - бот @get_id_bot, работает так же.

Хочешь, чтобы агент в Telegram отвечал в твоём стиле и помнил твои дела? Само подключение этого не даст. На практикуме за три вечера собираешь всю связку под себя: ИИ-клон + Второй мозг + Контекст-инжиниринг - именно она превращает ИИ из «помощника с галлюцинациями» в рабочий инструмент. Записи эфиров остаются в личном кабинете, доступ 30 дней.

Как передать токен в Hermes Agent и запустить шлюз?

1. Запусти мастер настройки

   bash

   hermes gateway setup

   Запусти команду на машине, где установлен Hermes. Мастер предложит список мессенджеров.

2. Выбери Telegram и введи данные

   Мастер спросит токен бота и разрешённые ID (можно несколько, через запятую) и запишет всё в настройки сам.

3. Запусти шлюз

   bash

   hermes gateway

   Шлюз поднимется и подключится к Telegram. Через несколько секунд напиши своему боту из приложения любое сообщение: если Hermes ответил - подключение готово.

Ручной путь вместо мастера выглядит так: открой файл ~/.hermes/.env и добавь две строки, подставив токен из BotFather и свой числовой ID из @userinfobot:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Вторая строка - список тех, кому бот вообще отвечает. Несколько человек пишутся через запятую. После сохранения файла шлюз запускается той же командой hermes gateway.

Если бот молчит даже в личке - смотри логи шлюза в том же терминале и первым делом проверь токен и свой ID в списке доступа; остальные ошибки разобраны в таблице в конце статьи.

Что умеет бот в Telegram на телефоне?

Чаще всего на телефоне нужны пять возможностей.

Текст и голосовые. Пишешь задачу словами или надиктовываешь голосовое - при настроенном распознавании речи Hermes расшифрует его в текст и поймёт. С локальным провайдером для этого не нужны никакие ключи, всё считается на той машине, где крутится агент.

Файлы и картинки. Можно переслать боту документ, таблицу, скриншот - агент получит их как вложения. Сгенерированные файлы он тоже умеет отправлять обратно: попросишь отчёт - пришлёт файлом в чат.

Подтверждения опасных действий. Когда агент собирается сделать что-то рискованное, например удалить файлы, он сначала спрашивает в чате: отвечаешь «yes» или «y» - делает, «no» или «n» - отменяет.

Кнопки вместо переписывания. Когда агенту нужно уточнение, он присылает вопрос с инлайн-кнопками вариантов - нажимаешь вариант, и агент продолжает работу. Команда /model без аргументов показывает меню выбора модели такими же кнопками.

Тихие уведомления. По умолчанию телефон звенит только на финальные ответы, запросы подтверждения и подтверждения команд. Служебные уведомления вроде «вызываю инструмент» и «сжимаю контекст» приходят без звука, поэтому телефон не звенит на каждом шаге. Если нужны звуковые уведомления на каждом шаге, переключи режим в настройках.

Как получать результаты фоновых задач в чат?

Домашний чат для расписания. Hermes умеет задачи по расписанию: «каждое утро в 7:43 собери мне сводку». Результаты он шлёт в домашний чат, который ты назначаешь один раз командой /sethome прямо в диалоге с ботом. Пока шлюз запущен, сводки приходят сами.

Фоновые задачи. Долгую задачу можно отправить в фон и заниматься своими делами: бот напишет, когда будет готово. Запущенная из топика задача вернёт ответ в тот же топик, ничего не потеряется.

Важное ограничение: бот отвечает, только пока запущен шлюз. Если выключить компьютер, на котором крутится Hermes, или перевести его в спящий режим, бот не ответит, пока машина снова не заработает. Чтобы бот был онлайн всегда, агента переносят на сервер: у нас это отдельная инструкция, как оставить Hermes Agent работать круглосуточно. По умолчанию шлюз сам опрашивает Telegram о новых сообщениях; для облачных платформ, которые засыпают без входящего трафика, в документации есть webhook-режим, где направление соединения разворачивается и Telegram сам стучится в бота.

Как закрыть бота от чужих?

Твой бот можно найти в поиске Telegram по юзернейму, поэтому защита держится на двух вещах: на списке доступа и на секретности токена.

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

Вторая - токен. Он не должен попадать в скриншоты, в пересланные сообщения, в репозитории. Если токен утёк, отзови его командой /revoke в BotFather. Потом пропиши новый токен в настройках и перезапусти шлюз.

Отдельно про группы: список доступа работает и там. Чужой человек в группе может написать боту что угодно - бот его проигнорирует. А если хочешь, чтобы бот в группе вообще отзывался, только когда его зовут, есть настройка telegram.require_mention - тогда он отвечает на упоминание через @, на ответ своему сообщению, на команду вида /command@твойбот и на совпадения с твоими шаблонами из telegram.mention_patterns, а на обычные сообщения группы не отвечает.

Почему бот молчит в группе и как это исправить?

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

Порядок починки:

1. Открой @BotFather и отправь /mybots.
2. Выбери своего бота.
3. Открой «Bot Settings» → «Group Privacy» → «Turn off».
4. Удали бота из группы и добавь заново.

Четвёртый пункт легко пропустить, и тогда бот «всё равно молчит». Telegram запоминает состояние приватности на момент, когда бот вступил в группу, и не обновляет его, пока бота не удалят из группы и не добавят снова.

Если отключать приватность глобально не хочется, есть второй путь: сделай бота администратором группы. Админ-боты получают все сообщения при любом режиме приватности.

Частые ошибки подключения и что с ними делать

Что ещё спрашивают про Hermes Agent в Telegram?

Один подключённый бот - начало. Если хочешь собрать вокруг него полную связку, приходи на практикум: ИИ-клон + Второй мозг + Контекст-инжиниринг, три эфира, записи доступны 30 дней.