tanaka.host  / блог
RSSЗаказать VPS
Введение/ИИ на сервере

Hermes Agent на VPS: установка, подключение модели и Telegram-бот

Ставим ИИ-агента Hermes от Nous Research на сервер, подключаем модель по API, привязываем Telegram-бота к своему ID и разбираем, почему локальная модель на CPU не работает. Debian 12, Ubuntu 24.04.

19 октября 2026 г.·6 мин чтения·hermes, ai-agent, telegram, nous

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

Как это устроено

Сам Hermes — не нейросеть. Он получает ваше задание, отправляет его модели вместе с описанием доступных инструментов и выполняет то, что модель решила сделать. Спросили, сколько места на диске — модель отвечает «выполни df -h», Hermes выполняет, отдаёт результат модели и только потом вы видите ответ. В одной задаче таких шагов могут быть десятки, поэтому от модели зависит почти всё: и качество, и стоимость.

Модель обычно подключают по API — DeepSeek, OpenRouter, OpenAI, Anthropic. Платите у поставщика по ключу, серверу не нужны видеокарта и много памяти. Одно жёсткое требование: контекст модели не меньше 64 000 токенов, иначе Hermes откажется с ней работать. Каждый запрос агента содержит длинную инструкцию с описанием инструментов и навыков — уже первый запрос занимает около 12,5 тысячи токенов, и нужен запас на многошаговую задачу.

Вторая часть — шлюз (gateway), постоянно работающая служба, связывающая агента с мессенджерами. Установщик регистрирует её как службу systemd.

Агент выполняет команды на сервере по-настоящему. Hermes работает с правами пользователя, от которого установлен, в этой инструкции это root. Опасные команды по умолчанию проверяются отдельно, но полностью полагаться на это не стоит. Ставьте Hermes на отдельный сервер без сайтов, баз и чужих данных.

Что нужно

  • Сервер на tanaka.host с Debian 12 или Ubuntu 24.04, не меньше 2 ГБ памяти. Агент со шлюзом занимают около 500 МБ в памяти и около 3,2 ГБ на диске.
  • Доступ по SSH под root.
  • Ключ API поставщика модели (DeepSeek, OpenRouter и т. п.).
  • Аккаунт в Telegram, если нужен бот.

1. Установка

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? — предлагает три пути:

  • Quick Setup (Nous Portal) — вход через аккаунт Nous Research без ключей API; запросы к моделям оплачиваются подпиской Nous Portal.
  • Full setup — вы сами выбираете поставщика и вводите свой ключ.
  • Blank Slate — минимальный агент: модель, файлы, терминал, остальное вручную.

Разбираем Full setup:

  1. В Select provider найдите поставщика (DeepSeek, OpenRouter) и нажмите Enter.
  2. Вставьте ключ в поле вида DEEPSEEK_API_KEY.
  3. Выберите модель из списка.
  4. Мастер по очереди спросит про поставщиков дополнительных инструментов (поиск в интернете и т. п.) — если не знаете, что выбрать, Skip — keep defaults.
  5. На Select platforms to configure просто Enter — Telegram подключим отдельно.

В конце мастер покажет, где лежат настройки: обычные параметры в /root/.hermes/config.yaml, ключи и токены в /root/.hermes/.env. Чтобы команда hermes заработала в текущем окне:

source ~/.bashrc

Поставщика и модель можно сменить в любой момент командой hermes model, переустанавливать не нужно.

3. Первый разговор в терминале

hermes

Появится приветствие с выбранной моделью, списком инструментов и навыков, внизу — строка ввода. Для проверки дайте задание, результат которого легко проверить: «Сколько свободного места на диске? Проверь командой». Если задача затянулась, напишите новое сообщение и нажмите Enter — это прервёт текущую. Выход — Ctrl+D, вернуться к последнему разговору — hermes -c.

4. Telegram

Сначала бот и ваш ID:

  1. В Telegram откройте @BotFather, отправьте /newbot, придумайте имя и адрес, оканчивающийся на bot (например my_hermes_bot). BotFather пришлёт токен вида 123456789:ABCdef… — сохраните и никому не показывайте.
  2. Напишите боту @userinfobot — он пришлёт ваш числовой ID.

На сервере:

hermes gateway setup
  1. В списке платформ — Telegram.
  2. How would you like to create your Telegram bot? — введите 2 (Manual).
  3. Telegram bot token — вставьте токен.
  4. Allowed user IDs — ваш ID; несколько пользователей — через запятую.
  5. На вопрос о Home Channel — Enter. Туда агент будет присылать результаты задач по расписанию.
  6. В списке платформ — Done, на Restart the gateway to pick up changes? — Enter.

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

Первым в мастере идёт вариант Automatic — Hermes обращается к сервису Nous Research и выдаёт ссылку на их служебного бота, который создаёт вашего бота без копирования токена. Ручной способ не зависит от сторонних сервисов, и токен вы получаете напрямую у Telegram.

После перезапуска напишите боту. Если молчит — состояние шлюза и журнал:

hermes gateway status
journalctl --user-unit hermes-gateway -n 50

Можно ли без платного API

Hermes умеет работать с моделью на самом сервере через Ollama: в мастере выбирается поставщик custom (direct API) с адресом http://127.0.0.1:11434/v1. Результат проверки на 4 ядрах и 8 ГБ памяти без видеокарты:

  • Сначала Hermes отказался — модель была подключена с контекстом 16 384 токена.
  • После увеличения контекста до 65 536 токенов первый запрос ушёл в qwen3:4b. Ответа не было и через 20 минут: модель должна сначала прочитать ~12,5 тысячи токенов запроса, а без GPU она делала это со скоростью от 27 до 10 токенов в секунду, замедляясь по мере чтения. Через 13 минут была прочитана только две трети.

Вывод: для Hermes на обычном VPS нужна модель по API. Своя модель — только на сервере с видеокартой. Как устроены локальные модели и сколько им нужно памяти — в статьях Ollama на CPU и DeepSeek через 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 и заново 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. Ждёт, когда модель начнёт отвечать. С облачной моделью это секунды; с локальной без видеокарты — десятки минут. Переключитесь на API через hermes model.

Код и документация — github.com/NousResearch/hermes-agent. Чтобы защитить сам сервер — UFW/firewalld и вход по ключу.