Hermes Agent – это ИИ-агент с открытым кодом от компании Nous Research. Он живёт на сервере, выполняет команды в терминале, работает с файлами, ищет информацию в интернете и умеет запускать задачи по расписанию. Общаться с ним можно прямо в терминале или через бота в Telegram. Главная особенность Hermes в том, что он учится на своей работе. После сложных задач агент сам записывает удачные способы решения в виде навыков и в следующий раз пользуется ими. В этой статье мы установим Hermes на VPS, подключим к нему модель и Telegram. Все шаги мы повторили на тестовом сервере с Debian 12, версия Hermes на момент проверки v0.22.2.
Как устроен Hermes Agent
Сам Hermes не является нейросетью. Это программа, которая получает ваше задание, отправляет его модели вместе с описанием доступных инструментов и выполняет то, что модель решила сделать. Например, вы спрашиваете, сколько места осталось на диске. Модель отвечает, что нужно выполнить команду df -h, Hermes её выполняет, отдаёт результат обратно модели, и только после этого вы получаете ответ. Таких шагов в одной задаче может быть десятки, поэтому от модели зависит почти всё. И то, насколько умно агент действует, и то, сколько стоит его работа.
Обычно модель подключают по API. Hermes отправляет запросы в облачный сервис, например DeepSeek, OpenRouter, OpenAI или Anthropic, а оплата идёт у этого сервиса по ключу API. Серверу в таком случае не нужны видеокарта и много памяти. Есть одно жёсткое требование. Модель должна поддерживать контекст не меньше 64 000 токенов, иначе Hermes откажется с ней работать. Каждый запрос агента содержит длинную инструкцию с описанием инструментов и навыков. На нашем сервере уже первый запрос занял около 12,5 тысячи токенов, и модели нужен запас, чтобы удержать в памяти ход многошаговой задачи.
Вторая часть – шлюз (gateway). Это постоянно работающая служба, которая связывает агента с мессенджерами. Через неё вы пишете боту в Telegram, а Hermes отвечает и присылает результаты задач по расписанию. Установщик сам регистрирует шлюз как службу systemd, и она запускается вместе с сервером.
Агент выполняет команды на сервере по-настоящему
Hermes работает с правами пользователя, от которого установлен, а в нашем примере это root. Опасные команды по умолчанию проверяются отдельно, и рискованные агент без вашего согласия не выполнит, но полностью полагаться на это не стоит. Ставьте Hermes на отдельный сервер, где нет сайтов, баз данных и чужих данных.
Что понадобится
- Сервер с Debian 12 или Ubuntu 24.04 и не меньше 2 ГБ памяти, например тариф DE-RZ9-1. На нашем сервере агент и шлюз вместе заняли около 500 МБ памяти, а сам Hermes со всеми компонентами около 3,2 ГБ на диске. Если сервера ещё нет, закажите его по инструкции.
- Подключение по SSH, например через Termius. Команды выполняются от имени
root. - Ключ API поставщика модели, например DeepSeek или OpenRouter. Ключ создают в личном кабинете поставщика, и там же оплачиваются запросы к модели.
- Аккаунт в Telegram, если хотите общаться с агентом через бота.
Шаг 1. Установите Hermes
Подключитесь к серверу и выполните официальную команду установки.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashУстановщик скачает Python, Node.js и всё остальное, что нужно агенту, в папку /root/.hermes. Когда загрузка закончится, сразу откроется мастер настройки.
Шаг 2. Пройдите мастер настройки
Мастер управляется с клавиатуры. Стрелки ↑ и ↓ выбирают вариант, Enter подтверждает выбор.
Первый вопрос How would you like to set up Hermes? предлагает три способа настройки.
Три способа настройки Hermes
- Quick Setup (Nous Portal) – вход через аккаунт Nous Research без ключей API. Сам вход бесплатный, а запросы к моделям оплачиваются подпиской Nous Portal.
- Full setup – вы сами выбираете поставщика модели и вводите свой ключ. Этот вариант подойдёт, если у вас уже есть ключ DeepSeek, OpenRouter или другого сервиса.
- Blank Slate – минимальный агент, у которого включены только модель, работа с файлами и терминал. Всё остальное подключается вручную.
Мы разберём Full setup с собственным ключом.
- Выберите Full setup.
- В списке Select provider найдите своего поставщика, например DeepSeek или OpenRouter, и нажмите Enter.
- Мастер попросит ключ, например строкой DEEPSEEK_API_KEY. Вставьте ключ и нажмите Enter.
- Выберите модель из списка, который покажет мастер.
- Дальше мастер по очереди спросит про поставщиков для дополнительных инструментов, например поиска в интернете. Если не знаете, что выбрать, выбирайте Skip — keep defaults.
- На вопросе Select platforms to configure просто нажмите Enter. Telegram мы подключим отдельно на шаге 4.
Когда мастер закончит, он покажет, где лежат настройки. Обычные параметры хранятся в файле /root/.hermes/config.yaml, а ключи и токены в /root/.hermes/.env. Чтобы команда hermes заработала в текущем окне терминала, выполните команду ниже.
source ~/.bashrcПоставщика можно сменить в любой момент
Команда hermes model снова открывает выбор поставщика и модели. Переустанавливать агента для этого не нужно.
Шаг 3. Поговорите с агентом в терминале
Запустите Hermes.
hermesНа экране появится приветствие с выбранной моделью, списком инструментов и навыков. Внизу находится строка ввода, куда пишется задание.
Hermes готов к работе, внизу строка для задания
Для первой проверки дайте простое задание, результат которого легко проверить, например «Сколько свободного места на диске? Проверь командой». Агент выполнит команду и ответит. Если задание затянулось, напишите новое сообщение и нажмите Enter, это прервёт текущую задачу. Выйти из Hermes можно сочетанием Ctrl + D, а вернуться к последнему разговору командой hermes -c.
Шаг 4. Подключите Telegram
Сначала создайте бота и узнайте свой номер в Telegram.
- Откройте в Telegram бота @BotFather и отправьте ему команду
/newbot. - Придумайте боту имя, а затем адрес, который заканчивается на
bot, напримерmy_hermes_bot. - BotFather пришлёт токен, строку вида
123456789:ABCdef…. Сохраните его и никому не показывайте. - Напишите боту @userinfobot. В ответ он пришлёт ваш числовой ID.
Теперь запустите на сервере настройку шлюза.
hermes gateway setup- В списке платформ выберите Telegram и нажмите Enter.
- На вопрос How would you like to create your Telegram bot? введите
2, то есть Manual. - В поле Telegram bot token вставьте токен от BotFather.
- В поле Allowed user IDs введите свой ID. Если пользователей несколько, перечислите их ID через запятую.
- На вопрос о Home Channel нажмите Enter. Туда агент будет присылать результаты задач по расписанию.
- В списке платформ выберите Done, а на вопрос Restart the gateway to pick up changes? нажмите Enter.
Токен скрыт звёздочками, бот отвечает только указанному ID
Не оставляйте список пользователей пустым
Если поле Allowed user IDs оставить пустым, мастер включит открытый доступ. Тогда любой, кто найдёт вашего бота, сможет давать агенту задания и выполнять команды на вашем сервере.
После перезапуска найдите своего бота в Telegram и напишите ему. Если бот молчит, проверьте состояние шлюза и его журнал.
hermes gateway status
journalctl --user-unit hermes-gateway -n 50Первым вариантом в мастере идёт Automatic. В этом режиме Hermes обращается к сервису Nous Research и выдаёт ссылку на их служебного бота, который создаёт вашего бота без копирования токена. Мы показали ручной способ, потому что он не зависит от сторонних сервисов и токен вы получаете напрямую у Telegram.
Можно ли обойтись без платного API
Hermes умеет работать и с моделью, запущенной на самом сервере, например через Ollama. Для этого в мастере выбирают поставщика custom (direct API) и указывают адрес http://127.0.0.1:11434/v1. Мы проверили этот вариант на тестовом сервере с 4 ядрами и 8 ГБ памяти, и вот что получилось.
Hermes видит модели Ollama на сервере
Сначала Hermes отказался работать, потому что модель была подключена с контекстом в 16 384 токена.
Hermes требует контекст не меньше 64 000 токенов
После того как мы увеличили контекст до 65 536 токенов, Hermes отправил модели qwen3:4b первый запрос. Ответа не было и через 20 минут. Перед ответом модель должна прочитать весь запрос, а это около 12,5 тысячи токенов. Без видеокарты она читала его со скоростью от 27 до 10 токенов в секунду, и чем больше было прочитано, тем медленнее шло дело. Через 13 минут модель прочитала только две трети запроса. Такой агент на практике бесполезен.
Вывод простой. Для Hermes на обычном VPS используйте модель по API. Если очень хочется своей модели, нужен сервер с видеокартой. Как устроены локальные модели и сколько им нужно памяти, мы разбирали в статье про DeepSeek R1 через Ollama.
Полезные команды
hermes # открыть агента в терминале
hermes -c # продолжить последний разговор
hermes model # сменить поставщика или модель
hermes setup # пройти мастер настройки заново
hermes gateway setup # подключить мессенджеры
hermes gateway status # состояние шлюза
hermes gateway restart # перезапустить шлюз
hermes doctor # проверить установку и настройки
hermes update # обновить HermesЕсли вы раньше пользовались OpenClaw, Hermes умеет перенести его настройки командой hermes claw migrate. Сначала она покажет, что будет перенесено, и попросит подтверждения, а с параметром --dry-run только покажет план и ничего не изменит.
Частые вопросы
hermes: command not found
Текущее окно терминала ещё не знает о новой команде. Выполните source ~/.bashrc или переподключитесь к серверу по SSH.
Model has a context window of 16,384 tokens, which is below the minimum 64,000
У выбранной модели слишком маленький контекст. Выберите другую модель командой hermes model. Если модель подключена через custom (direct API), например из Ollama, откройте файл /root/.hermes/config.yaml, найдите в разделе custom_providers свою модель и укажите для неё context_length: 65536. Помните о скорости, о которой мы писали выше.
Telegram bot token rejected: The token was rejected by the server
Токен введён с ошибкой или был отозван в BotFather. Мы получили эту ошибку, когда указали несуществующий токен, и шлюз после неё не запустился. Получите новый токен у @BotFather и заново пройдите hermes gateway setup.
Бот в Telegram не отвечает
- Проверьте, что ваш ID указан в списке разрешённых. Он хранится в строке
TELEGRAM_ALLOWED_USERSфайла/root/.hermes/.env. - Проверьте шлюз командой
hermes gateway status. Если он остановлен, запустите его командойhermes gateway restart. - Запустите
hermes doctor, он покажет ошибки в настройках.
Агент долго пишет waiting for the first stream chunk
Hermes ждёт, когда модель начнёт отвечать. С облачной моделью это обычно занимает секунды. Если вы подключили модель, запущенную на самом сервере без видеокарты, ожидание может растянуться на десятки минут. Переключитесь на модель по API командой hermes model.
Наши ресурсы
Telegram-канал: https://t.me/f3cloud_news
Официальный сайт: https://f3cloud.com