Обновление Hermes v2026.3.28: настройка Telegram стала проще

Обновление Hermes v2026.3.28: настройка Telegram стала проще

Telegram — один из самых популярных способов общения с вашим агентом Hermes. В этом обновлении мы отполировали процесс настройки и добавили несколько удобных новых опций. Новичок вы или опытный пользователь — это руководство поможет вам начать общаться с агентом в два счёта.

Шаг 1: Создайте своего бота

Начнём с главного: вам понадобится токен бота. Это что-то вроде секретного ключа, который позволяет Hermes управлять вашим ботом. Вот как его получить:

1. Откройте Telegram и найдите @BotFather (или перейдите по ссылке t.me/BotFather)
2. Отправьте /newbot
3. Выберите отображаемое имя (любое на ваш вкус, например, «Hermes Agent»)
4. Придумайте имя пользователя, которое заканчивается на bot (например, my_hermes_bot)
5. BotFather ответит вам вашим API-токеном

Ваш токен будет выглядеть примерно так:

123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

Важно: держите этот токен в секрете! Любой, у кого он есть, может управлять вашим ботом. Если он утёк, немедленно отзовите его командой /revoke у BotFather.

Шаг 2: Настройте бота (необязательно, но рекомендуется)

Вы можете сделать своего бота более дружелюбным с помощью нескольких быстрых команд BotFather:

Команда	Назначение
/setdescription	Текст «Что умеет этот бот?», показываемый перед началом чата
/setabouttext	Короткий текст на странице профиля бота
/setuserpic	Загрузка аватара
/setcommands	Определение меню команд /
/setprivacy	Управление видимостью сообщений в группах (см. шаг 3)

Для /setcommands хороший стартовый набор:

help - Показать справочную информацию
new - Начать новый разговор
sethome - Установить этот чат как домашний канал

Новое: индикатор статуса «В сети» / «Не в сети»

У Telegram-ботов нет зелёной точки «в сети», как у пользовательских аккаунтов. Но теперь вы можете показывать статус бота в его описании профиля! Включите это в своём конфиге:

gateway:
  platforms:
    telegram:
      extra:
        status_indicator: true
        status_online: "🟢 Online"
        status_offline: "🔴 Offline"

Статус обновляется на Online, когда шлюз подключается, и на Offline при корректном завершении работы. Учтите, что это глобально (видно всем), и при жёстком сбое статус не обновится — это ограничение Telegram.

Новое: приоритет меню команд

Hermes автоматически регистрирует своё меню команд при запуске шлюза. По умолчанию оно ограничено 60 командами для надёжности (Telegram допускает до 100, но большие объёмы данных могут не пройти). Вы можете настроить, какие команды будут отображаться первыми:

platforms:
  telegram:
    extra:
      command_menu:
        max_commands: 60
        priority_mode: prepend  # prepend | append | replace
        priority:
          - my_plugin_command

• prepend: сначала ваши команды, затем стандартные команды Hermes
• append: сначала стандартные команды Hermes, затем ваши
• replace: использовать только ваш список для порядка приоритета

Шаг 3: Режим конфиденциальности — самая частая ловушка

Это самый распространённый источник путаницы. У Telegram-ботов по умолчанию включён режим конфиденциальности. Это значит, что ваш бот может видеть только:

• Сообщения, начинающиеся с /
• Ответы на свои собственные сообщения
• Служебные сообщения (входы, выходы, закрепления)
• Сообщения в каналах, где он является администратором

При выключенном режиме конфиденциальности бот видит всё в группе.

Чтобы отключить его:

1. Напишите @BotFather
2. Отправьте /mybots
3. Выберите своего бота
4. Перейдите в Bot Settings → Group Privacy → Turn off

Предупреждение: после изменения этого параметра вы обязаны удалить бота из группы и добавить его заново. Telegram кэширует состояние конфиденциальности!

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

Новое: наблюдение за групповыми чатами без автоответов

Хотите, чтобы ваш бот видел сообщения в группе, но отвечал только когда его упоминают? Этот новый режим идеально для этого подходит:

telegram:
  allowed_chats:
    - "-1001234567890"
  group_allowed_chats:
    - "-1001234567890"
  require_mention: true
  observe_unmentioned_group_messages: true

С этой настройкой сообщения без упоминания из чатов из белого списка добавляются в транскрипт сессии как контекст, но не запускают агента. Последующее упоминание @имя_бота будет иметь полный контекст того, что было сказано.

Подводим итоги

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