Написать в Telegram

Hermes Agent: как собрать первого ИИ-агента на своём сервере и управлять им из Telegram. Пошагово

Содержание
  1. Чем агент отличается от чат-бота
  2. Что понадобится
  3. Если вы работаете из России
  4. Что важно знать до старта
  5. Шаг 1. Арендуем сервер с готовым шаблоном Hermes
  6. Шаг 2. Входим в панель агента
  7. Шаг 3. Подключаем модель
  8. Шаг 4. Проверяем агента
  9. Шаг 5. Подключаем Telegram
  10. Шаг 6. Даём первую работу: наблюдатель
  11. Сколько это стоит
  12. Что дальше

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

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

Разбираем по шагам: как поднять агента, подключить модель и Telegram и дать первое задание. И что из этого можно повторить в России.

Чем агент отличается от чат-бота

У агента три отличия.

  • Инструменты. Он ищет в интернете, читает и пишет файлы, запускает программы на своём компьютере.
  • Цель вместо вопроса. Вы ставите задачу, а шаги агент находит сам. Задачу можно повторять по расписанию, пока вас нет.
  • Память. Агент запоминает, как вам удобно, и со временем работает лучше.

Внутри любого агента сидит та же языковая модель, что и в ChatGPT или Claude. Разница в том, что построено вокруг неё.

У Hermes есть три отличия от подписок на готовые сервисы:

  • Свободный выбор модели. Можно поставить дешёвую модель на рутину и сильную на сложные задачи, в одном агенте.
  • Своя собственность. Это бесплатная программа на вашем сервере. Лимиты и отключённые функции от вас не зависят.
  • Свой аккаунт в мессенджере. Агент пишет вам в Telegram, а по списку каналов в панели ещё и в Discord, Slack, Matrix, Mattermost.

Ещё одна особенность: агент один, и он узнаёт всё о вашей работе. Что он выучил, записывает как навыки: пошаговые заметки, которые использует снова.

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

  • Сервер (VPS). Компьютер в дата-центре, который всегда включён и куда входите только вы. Самый маленький тариф стоит несколько долларов в месяц. В примере взят тариф KVM 1: 1 ядро, 4 ГБ памяти, 50 ГБ диска.
  • Аккаунт у поставщика модели. В примере это Nous Portal: один аккаунт даёт доступ к сотням моделей. По примеру, тариф за 20 долларов в месяц даёт 22 доллара кредитов.
  • Telegram на телефоне. Для подключения нужно будет навести камеру на QR-код.
  • Хранилище паролей. Пароль администратора нельзя держать в блокноте.

Почему именно сервер, а не ноутбук. Он должен быть всегда включён: расписание и сообщения в три часа ночи не работают, если ноутбук лежит в сумке. Он должен быть отделён от ваших вещей: агент ставит программы и удаляет файлы, поэтому ни личных фото, ни паролей, ни браузера с банком на нём быть не должно. И он должен быть доступен с любого устройства. Это рабочая мастерская: если сломали, удалили и начали заново за 10 минут.

Если вы работаете из России

Сам Hermes бесплатный, с открытым кодом и работает на сервере, который вы арендуете.

Ограничения в сопутствующих сервисах. В примере используются зарубежный хостинг и подписка Nous Portal. Оплата зарубежных сервисов из России может быть затруднена, проверьте это заранее. Если не получится, замены такие:

  • Сервер. Арендуйте VPS у российского провайдера. Установка готовым шаблоном в примере привязана к выбранному хостингу. На другом сервере шаги будут иными, и их придётся искать в документации Hermes.
  • Модель. Hermes подключается к моделям разных компаний, так что привязки к одной нет. Выбирайте модель, доступную вам: открытую, запущенную на своём сервере, или российскую, если у неё есть программный доступ. Можно ли подключить конкретную российскую модель, проверяйте в разделе провайдеров панели. Готового примера с такой моделью здесь нет.
  • Мессенджер. В примере Telegram. Если он вам не подходит, посмотрите список каналов в панели: там есть и другие.

Что важно знать до старта

  • Интерфейс меняется. Проект обновляется постоянно, кнопки у вас могут называться иначе. Ориентируйтесь на общую идею, а не на точные подписи. В примере панель версии 0.21.1.
  • Агент выполняет команды. Он может удалять и перезаписывать файлы. Поэтому сервер отдельный и пустой.
  • Telegram не шифрует чаты с ботами. Не отправляйте агенту пароли и банковские данные.
  • Расходы. Сервер стоит фиксированную сумму. Модель тарифицируется за каждое сообщение, расходы видны на странице usage в Nous Portal.
  • Долгие задачи. Первое поручение с созданием навыка заняло в примере около 30-45 минут. Это нормально, агент разбирался сам.

Шаг 1. Арендуем сервер с готовым шаблоном Hermes

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

Выберите тариф KVM 1: он самый маленький и спокойно тянет одного агента. Если не хватит, тариф можно повысить без переустановки.

В корзине выберите срок оплаты. По примеру скидка начинается от 12 месяцев, а на любой срок действует гарантия возврата 30 дней. Снимите галочку с пункта про готовый ИИ-сервис: он подписывает на лишнюю услугу, а свою модель вы подключите чуть позже. Остальные дополнения не трогайте.

После оплаты откроется форма настройки Hermes. Оставьте имя администратора hermes или придумайте своё и запомните его. Нажмите на значок глаза, чтобы увидеть пароль, скопируйте и сохраните в менеджере паролей. Потом нажмите Deploy.

Форма настройки Hermes: логин администратора, пароль и кнопка Deploy
Форма настройки Hermes: логин администратора, пароль и кнопка Deploy

Дальше откроется панель хостинга. Подождите несколько минут, пока приложение не получит зелёную отметку и статус running. В разделе Docker Manager видны два приложения: сам Hermes Agent и Traefik, который защищает соединение с сервером.

Docker Manager: Hermes Agent и Traefik в статусе Running
Docker Manager: Hermes Agent и Traefik в статусе Running

Шаг 2. Входим в панель агента

В Docker Manager найдите строку Hermes Agent и в столбце Access нажмите Open. Откроется страница входа в панель. Сохраните адрес в закладки и войдите с логином и паролем, которые записали раньше.

Это пульт управления агентом. Слева меню:

  • Sessions. Все разговоры агента на любых устройствах. Память у них общая.
  • Models. Выбор модели, которая думает.
  • Cron. Расписание, по которому агент работает, пока вы спите.
  • Channels. Подключение мессенджеров.
  • Keys. Ключи и входы к поставщикам моделей.

Внизу слева виден статус шлюза Gateway. Это часть, которая передаёт сообщения вам на телефон и обратно.

Если открыть чат и написать «Hello», ответа не будет. Вместо него появится ошибка: no inference provider configured. Агент установлен и запущен, но думать пока не может: ему не подключена модель.

Чат в панели: агент не отвечает, так как не настроен поставщик модели
Чат в панели: агент не отвечает, так как не настроен поставщик модели

Шаг 3. Подключаем модель

Зайдите в раздел Keys. Первым в списке входов стоит Nous Portal, его делает та же команда, что и сам Hermes. Он встроен в агента, поэтому ключи копировать не нужно: нажмите Login справа. Откроется окно с запросом доступа для агента, нажмите Connect. После подтверждения закройте вкладку. В списке появится отметка Connected.

Раздел Keys: список входов к поставщикам, у Nous Portal кнопка Login
Раздел Keys: список входов к поставщикам, у Nous Portal кнопка Login

Теперь выберите модель. Откройте Models, нажмите Change у основной модели. Откроется список моделей поставщика. Пока вы учитесь, берите быструю и дешёвую: сообщений будет много. В примере выбрана DeepSeek Flash. В списке видны варианты DeepSeek V4 Pro, V4 Pro 0813 и V4 Flash 0731. Версии в списке со временем меняются, берите самую свежую Flash. Модель хороша в работе с инструментами, а сообщение с ней стоит доли цента.

Нажмите Switch, подтвердите перезагрузку и вернитесь в чат.

Окно выбора основной модели: в поиске deepseek, среди вариантов V4 Flash
Окно выбора основной модели: в поиске deepseek, среди вариантов V4 Flash

Шаг 4. Проверяем агента

В чате справа вверху теперь указана выбранная модель. Напишите «Hello»: агент ответит. Две минуты назад он не мог ответить ни на что.

Спросите, какие у него инструменты: What tools do you have?

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

Ответ агента со списком инструментов: браузер, терминал, файлы, код, поиск, память и расписание
Ответ агента со списком инструментов: браузер, терминал, файлы, код, поиск, память и расписание

Шаг 5. Подключаем Telegram

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

В панели откройте Channels и найдите Telegram. Он выключен. Включите переключатель справа вверху и нажмите Restart Gateway. Шлюзу нужно несколько минут, чтобы подняться. Если он не включился, обновите страницу браузера. После этого панель покажет, что шлюз работает, но токен бота не задан.

Раздел Channels: у Telegram нет токена бота, есть быстрая настройка через QR-код
Раздел Channels: у Telegram нет токена бота, есть быстрая настройка через QR-код

Нажмите Create with QR и наведите камеру телефона на код. Откроется чат с ботом. Нажмите Create bot, затем Create. Телефон перекинет вас в чат с новым агентом, но подключение ещё не завершено. Вернитесь назад в Telegram и откройте чат с ботом из списка. Если его там нет, отсканируйте код снова. В чате будет сообщение «подключить этого бота к настройке Hermes». Нажмите Connect this bot.

В ту же секунду бот появится в панели. Там видно имя бота и разрешённого пользователя: это ваш Telegram ID. Нажмите Save and restart и снова подождите несколько минут. Если статус не стал зелёным, обновите страницу. Дальше в Telegram откройте бота, нажмите Start и напишите сообщение, например:

Привет! Ты меня слышишь?

Одной команды Start мало, разговор начинается с вашего сообщения. Агент ответит, а ещё напишет, что для Telegram не задан домашний канал. Это место, куда Hermes присылает результаты заданий по расписанию. Нажмите /sethome, и этот чат станет домашним.

Telegram и панель рядом: бот подключён, агент отвечает и предлагает команду /sethome
Telegram и панель рядом: бот подключён, агент отвечает и предлагает команду /sethome

С безопасностью просто. Мастер подключения внёс ваш аккаунт в список разрешённых, поэтому если кто-то найдёт бота и напишет ему, он не получит ответа.

Шаг 6. Даём первую работу: наблюдатель

У агента теперь есть дом, модель и связь с вами. Хорошее первое задание это наблюдатель. Он проверяет что-то по расписанию и пишет вам только когда что-то изменилось. Вы объясняете один раз, что вас интересует, а агент сам создаёт навык проверки, ставит себя на расписание и ведёт память о том, что уже показывал.

Такое сообщение можно отправить и в панели, и из Telegram: агент один и тот же. Для примера возьмём цены на авиабилеты. Текст задачи по-русски:

Следи за ценами на рейсы Барселона-Лондон. Создай для себя навык проверки, который можно использовать повторно, помни, что ты уже мне показывал, ставь проверку на расписание раз в несколько часов и пиши мне в Telegram, только если появилось что-то новое.

Агент вышел в интернет, выбрал способ проверки, написал скрипт, создал навык, поставил его на расписание и завёл память. По часам это заняло около 30-45 минут. Всё это время можно заниматься своими делами.

В списке запланированных заданий появилось новое: проверка цены раз в 360 минут, то есть каждые 6 часов. В описании задания агент записал правила. Скрипт без участия модели берёт самый дешёвый билет туда и обратно, сравнивает с сохранённым состоянием и пишет в Telegram только если цена обновила минимум или упала не меньше чем на 10 евро. Если проверка не удалась, прошлое значение не затирается, а после трёх неудач подряд приходит короткое сообщение о восстановлении.

Список заданий: проверка цен на рейсы раз в 360 минут с правилами уведомлений
Список заданий: проверка цен на рейсы раз в 360 минут с правилами уведомлений

Когда цена изменилась, в Telegram приходит такое сообщение: самый дешёвый билет туда и обратно 30 евро на 31 октября, остальные в этом окне доходят до 135 евро, агент напишет, когда цена опустится ниже 30.

Сообщение агента в Telegram: цена билета, сравнение с другими датами и порог следующего уведомления
Сообщение агента в Telegram: цена билета, сравнение с другими датами и порог следующего уведомления

Вы описали результат один раз, дальше он приходит сам. Таким же образом можно следить за ценой товара, новостями по теме или завтрашней погодой. Если сайт блокирует агентов, попросите найти другой источник.

Сколько это стоит

Сервер стоит фиксированную сумму в месяц. Модель стоит доли цента за сообщение, и расходы видны на странице usage в Nous Portal. В первый день работы агента модель обошлась в примере чуть больше чем в 8 центов.

Что дальше

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

Мы в Агентехе учим сотрудников собирать ИИ-агентов под задачи своего отдела, ставить им понятные границы и безопасно запускать в работу. Как устроено обучение.

Написать в Telegram