Сережа Рис.

Hermes Agent в Telegram: как принять видео больше 20 МБ

Hermes Agent в Telegram не берёт видео больше 20 МБ: это лимит Telegram Bot API. Как настроить локальный Bot API и принимать файлы до 2 ГБ, опыт на двух ботах.

Содержание 9 разделов

Hermes Agent в Telegram не скачивает видео и файлы больше 20 МБ. Это лимит облачного Telegram Bot API, сам Hermes тут ни при чём. Лимит снимает локальный сервер Bot API, который стоит рядом с агентом: с ним бот принимает файлы до 2 ГБ. Я перевёл так двух своих ботов, оба раза всю работу сделал агент.

Началось с мамы. У неё свой бот на Hermes, он помогает ей готовить материалы к урокам. 20 ноября она отправила ему видео на 80 МБ, и бот его не взял. В логе осталась строка Skipped oversized user video.

Почему бот в Telegram не берёт большие файлы: лимиты Bot API

Hermes общается с Telegram через Bot API. Облачный сервер api.telegram.org отдаёт боту файлы не больше 20 МБ, так написано в документации Bot API. Голосовое на пять минут пройдёт. Запись урока или ролик с телефона уже нет.

Что такое локальный Telegram Bot API

У Telegram есть открытый сервер telegram-bot-api: тот же Bot API, только на вашей машине. В режиме --local он скачивает файлы без ограничения размера и отправляет файлы до 2000 МБ. В документации Hermes этому посвящён раздел Large Files via Local Bot API Server. Когда Hermes видит в конфиге свой адрес сервера, он сам поднимает внутренний лимит с 20 МБ до 2 ГБ.

Документация Hermes: раздел про файлы больше 20 МБ и локальный сервер Telegram Bot API

Кадр из документации Hermes: облачный Bot API отдаёт файлы до 20 МБ, локальный сервер поднимает потолок до 2 ГБ

flowchart LR
    T[Telegram] --> C[Облачный Bot API<br/>файл до 20 МБ]
    C --> H1[Hermes]
    T --> L[Свой сервер Bot API<br/>файл до 2 ГБ]
    L --> D[Файл на диске сервера]
    D --> H2[Hermes]

Что нужно заранее

  • Hermes на своём сервере и бот, который уже отвечает. Если бота ещё нет, начните с опоры Hermes Agent: что это и как пользоваться.
  • Пара api_id и api_hash. Их выдаёт Telegram на странице my.telegram.org/apps: входите со своим аккаунтом и создаёте приложение с любым названием. Этот шаг за вами: Telegram просит войти лично.
  • Место на диске. Сервер складывает скачанные файлы у себя.

Какую задачу дать агенту

Задачу я ставил своему агенту в Claude Code, у него есть доступ к серверу с ботом. Вот промпт, который можно отдать вашему:

Промпт
Бот на Hermes не принимает видео больше 20 МБ. Подними рядом с ним локальный telegram-bot-api по разделу Large Files из документации Hermes (messaging/telegram). Сервер слушает только 127.0.0.1 и работает под тем же пользователем, что и Hermes. Перед правкой сохрани конфиг и запиши команды отката. Токен бота и api_hash в чат и в git не выводи: я положу их в файл окружения сам. В конце отправь боту файл больше 20 МБ и покажи строку из лога, что файл скачан.

Как агент настроил Hermes Agent на локальный Bot API

  1. Поставил сервер. Документация Hermes советует самый простой путь: Docker-образ aiogram/telegram-bot-api. У меня агент собрал официальный сервер из исходников и завёл его службой под тем же пользователем, что и Hermes. Так бот сразу читает скачанные файлы, без возни с правами.
  2. Закрыл порт. Сервер слушает только 127.0.0.1:8081. Токен бота идёт прямо в адресе запроса, другой защиты у сервера нет. Кто достучался до порта, тот управляет ботом.
  3. Вывел бота из облака. Бот работает только с одним сервером Bot API, поэтому из облачного его выводят методом logOut. Обратно в облако Telegram пускает через 10 минут. Поэтому сначала агент проверил, что локальный сервер отвечает на getMe.
  4. Прописал адрес в конфиге Hermes. Три строки в ~/.hermes/config.yaml:
platforms:
  telegram:
    extra:
      base_url: http://127.0.0.1:8081/bot
      base_file_url: http://127.0.0.1:8081/file/bot
      local_mode: true
  1. Перезапустил шлюз и посмотрел лог. Там должны появиться строки Using custom Telegram base_url и Using Telegram local_mode.
  2. Поставил ffmpeg и чистку. С ffmpeg агент режет ролик и достаёт из него кадры. Чистка раз в сутки удаляет скачанные файлы старше семи дней.

Как проверить, что всё работает

Отправьте боту файл больше 20 МБ. У маминого бота тестовый файл на 25 МБ скачался за две секунды.

На втором боте я проверял видео. Ролик на 25 МБ ушёл боту с вопросом, сколько в файле байт и сколько секунд он длится. Через 15 секунд бот ответил: «25 133 295 байт (это больше 20 МБ), 20 секунд: большое видео дошло».

Вторым ботом пользуется моя жена. Она отправила ему большой ролик и написала, что с ним сделать: порезать лучшие моменты, добавить минималистичные субтитры и кадрировать. Бот скачал файл и взялся за работу. Раньше такое видео до него не доходило.

Теперь она монтирует видео в переписке. Кидает Hermes исходник с телефона и пишет словами, что нужно. Режет и клеит он сам, через ffmpeg на сервере.

В логе шлюза на каждый такой файл появляется строка Cached user video at с путём к файлу.

На чём можно споткнуться

Адрес без /bot. Hermes 0.23 сам дописывает /bot к голому адресу сервера. Hermes 0.22 передаёт адрес как есть, поэтому агент сразу написал полные адреса. Они работают на обеих версиях.

Не тот раздел конфига. Строки стоят в platforms.telegram.extra. Ключи под верхним telegram.extra Hermes молча пропускает.

Права на файлы. В режиме local_mode Hermes читает файл прямо с диска. Если сервер пишет файлы от другого пользователя, в логе будет Not Found. Поэтому агент запустил сервер и Hermes под одним пользователем.

Диск. Каждое присланное видео остаётся на сервере. Без чистки диск тихо заполнится.

Откат. Бота выводят из локального сервера тем же logOut, конфиг возвращают из копии. Попросите агента записать эти команды до первой правки.

Второй бот одним сообщением

На следующий день я написал агенту: «Ты вчера сделал для мамы бота, который может принимать видео. Можешь то же самое сделать для второго?»1 Второй бот: помощник жены. Агент нашёл свою вчерашнюю запись о работе, перенёс готовый сервер на вторую машину и повторил шаги. От меня понадобилось одно «да»: на отправку тестового видео.

Главный вывод такой. Я прошу агента записывать, что он сделал и как это откатить. Завтра эта запись становится инструкцией для следующего бота, и вторая настройка стоит мне одного сообщения.

Похожие серверные связки и агентские отделы я собираю в Personal Corp. Посмотреть, как это устроено.

Как подключить к такому боту подписку Claude, я разобрал в посте как подключить подписку Anthropic к Hermes. Ещё про Hermes в работе: бот Hermes как менеджер между мной и подрядчиком.


Ссылки


  1. Опечатки в реплике исправлены, имя бота заменено словом «второго». ↩︎

Автор
Сережа Рис.

Архитектор агентных систем на Claude Code. Веду телеграм-канал, YouTube и лучшее сообщество вайбкодеров.