Hermes Agent: установка, настройка и подключение к Telegram для новичков

Введение: зачем смотреть в сторону Hermes Agent

В этом материале разберём установку Hermes Agent — или, как его можно называть по-русски, «агента Гермеса».

Почему стоит обратить внимание именно на Hermes Agent? Сейчас уже есть агенты на Claude Code, Gemini, Codex. Все эти агенты могут работать через официальные подписки. То есть мы не платим отдельно за использование API, а взаимодействуем с агентами через Telegram-чат, через специализированный мост. На первый взгляд, этого уже достаточно: такие агенты действительно хорошо работают, выполняют большой объём задач и в целом показывают себя очень мощно.

Но в последнее время всё чаще появляются ситуации, когда люди сталкиваются с ограничениями. У кого-то не получается оплатить подписку. У кого-то возникают региональные ограничения. У кого-то блокируют аккаунт, особенно при работе с Claude Code. В Gemini у многих тоже бывают проблемы: люди не могут нормально зарегистрироваться, потому что получают сообщения о временных ограничениях.

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

Что такое Hermes Agent и почему он удобен

Прежде чем переходить к установке, стоит коротко разобраться, что такое Hermes Agent и в чём его преимущество.

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

То есть вместо того, чтобы каждый раз говорить ему: «Запомни, в следующий раз мы будем делать это так же», агент может сам создавать скиллы и применять их в похожих ситуациях. Это делает его удобным не только для разовых задач, но и для регулярной работы, где со временем важно накапливать опыт и повторять успешные сценарии.

Куда можно установить Hermes Agent

Есть несколько вариантов установки Hermes Agent.

Первый вариант — установить его на локальный компьютер. Это может быть ноутбук, MacBook или другая система, на которой можно запустить агента. В этом случае вы можете использовать локальную LLM-модель через Ollama или другой похожий сервис. Преимущество такого подхода в том, что можно работать бесплатно, без оплаты API. Но для этого нужен достаточно производительный компьютер, потому что скорость ответа агента будет зависеть от вашего железа.

Второй вариант — установить Hermes Agent на VDS-сервер. Лично мне этот вариант нравится больше. Вы покупаете VDS-сервер, желательно за пределами регионов, где могут возникать ограничения, и устанавливаете агента туда. Это важно, чтобы агент не отвечал, что у него есть региональные ограничения или недоступны какие-то сервисы.

Преимущество VDS-сервера в том, что агент не живёт на вашем основном компьютере. Он находится в отдельной среде и может быть доступен 24/7. Его работа не зависит от того, открыт у вас ноутбук или закрыт. Минус в том, что на дешёвый сервер обычно нельзя нормально поставить локальную модель. Если использовать самый простой сервер, например за несколько долларов в месяц, ресурсов для локальной LLM может не хватить.

В таком случае лучше подключать Hermes к платной модели через API. Для этого можно использовать OpenRouter: через него удобно выбрать модель, на которой будет работать агент.

Выбор модели и расходы на API

Для Hermes Agent можно выбрать разные модели. Есть дорогие модели вроде ChatGPT, Gemini Pro или Claude Sonnet, а есть более бюджетные варианты, которые можно использовать для тестов и небольших задач.

Один из возможных вариантов — модели DeepSeek. Также можно смотреть в сторону моделей Gemma/Gemini и других моделей, доступных через OpenRouter. Смысл в том, что Hermes не привязан к одному конкретному провайдеру. Вы можете выбрать модель под свои задачи, бюджет и требования к качеству.

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

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

Подготовка сервера и установка Hermes Agent

Для начала нужен сервер: VDS или другая среда, где будет установлен Hermes. Первым делом нужно убедиться, что на сервере установлен Git. Для этого можно выполнить команду проверки версии Git. Если Git не установлен, его нужно установить.

Дальше установка запускается одной командой из инструкции. Команду нужно скопировать в терминал на сервере, после чего начнётся процесс установки Hermes Agent.

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

Установщик сам поставит необходимые зависимости: Python, Node.js и другие компоненты, если их нет. Часть действий можно было бы выполнить вручную, но для новичков удобнее идти по готовой инструкции и использовать автоматическую установку.

Во время установки Hermes предлагает выбрать вариант: быстрая установка или полная. Для первого запуска можно выбрать быструю установку. После этого установщик сам проходит по основным настройкам.

Подключение OpenRouter и выбор провайдера

На следующем этапе нужно выбрать, через какого провайдера будет работать модель.

В списке могут быть разные варианты: официальные API Claude, LLM Studio, OpenRouter и другие поставщики моделей. Если мы хотим работать через OpenRouter, выбираем OpenRouter.

Для этого нужно зайти в OpenRouter и создать новый API-ключ. Ключ можно назвать, например, Hermes. Также желательно сразу поставить лимит расходов. Например, можно ограничить использование ключа суммой в 10 долларов на этапе теста.

После создания ключ нужно добавить в настройку Hermes. Хорошо, если система не показывает ключ открытым текстом в чате или терминале. Но всё равно важно помнить: API-ключ — это чувствительная информация. Его нельзя публиковать, отправлять посторонним людям или хранить в открытом виде.

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

Где будет работать агент

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

Некоторые настройки можно выполнить сразу, а некоторые — позже. На этапе первичной настройки можно выбрать платформу для взаимодействия с агентом. Hermes может работать через разные каналы: email, WhatsApp, WeChat, Google Chat, Line, Microsoft Teams и другие. Но для начала удобнее всего настроить Telegram.

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

Проверка установки через Visual Studio Code

Чтобы посмотреть, как Hermes установился на сервер, удобно использовать Visual Studio Code. Через него можно подключиться к серверу и увидеть папку Hermes. Внутри находятся файлы документации, конфигурации и другие внутренние файлы агента.

Через терминал можно запустить Hermes и проверить его состояние. В инструкции есть команды для запуска чата Hermes, выбора модели, проверки конфигурации и диагностики. Например, можно выполнить команду Hermes Doctor, чтобы проверить, всё ли настроено корректно.

Если нужно поменять модель, можно снова вызвать команду выбора модели и выбрать OpenRouter или другого провайдера.

Файлы soul.md и agents.md

В Hermes есть файлы вроде soul.md и agents.md. В них можно описывать, кто такой агент, как он должен себя вести, для каких задач используется и какой у него контекст.

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

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

Создание Telegram-бота

Теперь подключим Hermes к Telegram.

Сначала нужно создать Telegram-бота через BotFather. Для этого открываем BotFather, создаём нового бота, задаём ему имя и получаем токен. Этот токен нужно скопировать и добавить в конфигурацию Hermes.

В Hermes есть файл .env. В нём хранятся переменные окружения, в том числе API-ключи и токены. Очень важно не показывать этот файл другим людям и не отправлять его никому, потому что внутри находятся ваши ключи. Если кто-то получит доступ к .env, он сможет использовать ваши API-ключи и управлять подключёнными сервисами.

В файле .env нужно найти строку TELEGRAM_BOT_TOKEN или аналогичную строку для Telegram-токена и вставить туда токен, который вы получили от BotFather.

Кроме токена бота нужно указать Telegram User ID — идентификатор пользователя, которому разрешено общаться с ботом. Это нужно для безопасности, чтобы бот не отвечал всем подряд. Свой User ID можно получить через специального Telegram-бота, например get ID Bot. После этого ID нужно добавить в список разрешённых пользователей.

Есть два способа настройки. Первый — вручную зайти в файл .env через Visual Studio Code и аккуратно прописать токены. Второй — передать агенту токен и User ID и попросить его подключить Telegram. Но второй способ менее безопасен, потому что вы отправляете ключ прямо агенту. Поэтому лучше настраивать всё вручную.

Первая ошибка: OpenRouter API-ключ не подхватился

После первичной настройки нужно проверить, может ли Hermes писать в Telegram.

Иногда на этом этапе возникает ошибка: Hermes не видит API-ключ OpenRouter. Такое может произойти, если ключ не был корректно прописан в .env, если в файле появились лишние строки или если один и тот же ключ был добавлен несколько раз.

Исправить это можно вручную: зайти в .env, удалить лишние строки и добавить правильный API-ключ. Также можно использовать специальную команду для обновления ключа, если она предусмотрена настройкой Hermes.

После этого нужно снова запустить Hermes и проверить, видит ли он OpenRouter. Если всё настроено правильно, агент должен ответить в терминале и начать работать через выбранную модель.

Проверка Telegram-подключения

После настройки токена и User ID можно написать агенту и попросить его отправить сообщение в Telegram.

Если агент отвечает, что Telegram ещё не настроен, нужно проверить файл .env. Возможно, строки с Telegram-токеном закомментированы. В таком случае их нужно раскомментировать и сохранить файл.

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

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

Дальше бот может попросить назначить домашний канал для автоматических уведомлений и cron-сообщений. Для этого в чате с ботом нужно выполнить соответствующую команду, например set home, если такая команда предусмотрена настройкой. После этого текущий чат станет основным каналом для автоматических сообщений.

Проверка голосовых сообщений

Следующий шаг — проверить, умеет ли Hermes принимать голосовые сообщения.

Можно отправить агенту голосовое сообщение и спросить, может ли он его обработать. Если распознавание речи не настроено, агент сообщит, что пока не может прослушать голосовое сообщение, потому что не настроен STT-провайдер.

В таком случае нужно настроить распознавание речи. Hermes может проверить конфигурацию и посмотреть, доступен ли Whisper или другой STT-провайдер. В некоторых конфигурациях может быть включён локальный провайдер fast-whisper, но сам пакет ещё не установлен.

Fast-whisper — это бесплатный вариант, который работает прямо на сервере и не требует отдельного API-ключа. После установки пакета нужно перезапустить шлюз, чтобы он начал использовать распознавание речи.

Здесь может возникнуть ещё один нюанс: если процесс был запущен вручную, команда restart может остановить шлюз, но не запустить его обратно. Поэтому лучше установить Telegram-шлюз как системный сервис. Тогда он будет работать как фоновая служба, а перезапуск будет происходить корректно.

После этого можно снова отправить голосовое сообщение и проверить, начал ли бот его распознавать.

Системные сообщения и поведение Telegram-бота

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

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

Это можно настроить позже, когда базовая связка Hermes — модель — Telegram уже будет стабильно работать.

Что находится внутри Hermes Agent

Через Visual Studio Code можно посмотреть структуру Hermes Agent. Внутри есть папки со скиллами. По умолчанию установлено довольно много скиллов.

Здесь важно сразу сказать о безопасности. Когда вы устанавливаете скиллы для своего AI-агента, желательно, чтобы они не были скачаны с непонятных сторонних источников. Агент с доступом к терминалу — это агент с доступом ко всему, что есть на вашем сервере. Если установить вредный или непроверенный скилл, можно создать себе серьёзные проблемы.

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

Когда мы работаем с официальными системами вроде Codex, Claude Code или Gemini, мы хотя бы понимаем, кто стоит за этими продуктами. В случае сторонних open-source-агентов риски выше, и их нужно учитывать.

Ограничения и минусы Hermes Agent

У Hermes Agent есть не только преимущества, но и ограничения.

Во-первых, на Windows он нормально работает только через WSL. Если вы на Windows и не знаете, что такое WSL, придётся разобраться. Либо можно сразу использовать VPS/VDS-сервер, как в этом примере.

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

В-третьих, Hermes — это не SaaS-сервис, который просто включил и забыл. Это скорее собственный серверный инструмент. Его нужно иногда обновлять, проверять, делать бэкапы, следить за расходами и контролировать фоновые процессы.

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

Главный риск: слишком много автономии

Главный риск AI-агентов — дать им слишком много свободы в автономных задачах.

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

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

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

Безопасность Telegram-бота

Если кто-то получит доступ к вашему Telegram-боту, он может получить управление агентом. А если агент имеет доступ к терминалу, значит, через него потенциально можно управлять сервером.

Поэтому есть несколько базовых правил.

Первое: не запускайте агента с root-доступом, если в этом нет необходимости.

Второе: обязательно указывайте разрешённых пользователей через allow list. В Telegram должен быть прописан только ваш User ID.

Третье: не устанавливайте чужие скиллы без проверки. Читайте, что они делают, откуда скачиваются, какие команды выполняют.

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

Планировщик, Obsidian-память и дополнительные возможности

У Hermes можно настроить память через Obsidian. Также можно использовать планировщик задач: встроенный cron или отдельные настройки внутри агента. Есть возможность использовать параллельных сабагентов, системные скиллы, MCP-интеграции. Агент может работать 24/7, если он установлен на сервер.

По набору возможностей Hermes во многом похож на другие AI-агентские системы. Отличие скорее в том, что он open-source, не привязан к одному провайдеру моделей и может самообучаться через скиллы.

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

Но если нужна максимальная глубина рассуждений, официальная экосистема, глубокая специализация под конкретный стек и работа через подписку, то Claude Code, Codex или Gemini могут быть предпочтительнее.

Лучшая конфигурация зависит от задачи. Можно использовать Hermes как отдельного агента. Можно использовать Claude Code. Можно держать несколько агентов и распределять между ними разные задачи.

Первичная настройка поведения агента

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

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

Главное — чтобы у вас в голове были задачи, которые вы хотите делегировать AI-агенту. Это, наверное, самый важный момент. Сам по себе агент ничего не решит, если вы не понимаете, для чего он вам нужен. Но если у вас есть понятные сценарии — работа с файлами, кодом, сервером, Telegram, расписанием, голосовыми сообщениями, подготовкой материалов, — тогда Hermes можно постепенно превратить в полезного помощника.

Финальный вывод

Мы разобрали установку Hermes Agent, подключение к OpenRouter, выбор модели, настройку Telegram-бота, работу с токенами, ограничение доступа по User ID, проверку Telegram-связки и первичную настройку голосовых сообщений.

Hermes Agent действительно выглядит как удобный вариант для новичков, особенно если есть проблемы с официальными подписками, оплатой, регистрацией или региональными ограничениями. Но важно помнить: это не просто чат-бот. Это агент, который может получить доступ к серверу, файлам, терминалу и внешним сервисам. Поэтому его нужно настраивать аккуратно, следить за API-расходами, ограничивать права и не давать ему лишней автономии.

Смысл работы с такими агентами везде примерно один: будь то Hermes, Codex, Gemini или Claude Code. Где-то агенты используются через API, где-то через подписку. Но главное — не сама установка, а понимание задач, которые вы хотите передать агенту, и правил, по которым он должен работать.

Читать 2 часть: Hermes Agent после установки