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

Hermes Agent ставится одной командой. На Linux, macOS и WSL2 это curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash, на Windows в PowerShell iex (irm https://hermes-agent.nousresearch.com/install.ps1). Дальше hermes model, пункт Custom endpoint, адрес https://api.claudexia.tech/v1, ключ sk_cdx_..., имя модели и размер контекста. Команда hermes открывает чат. Остальное в статье про то, где на Windows можно споткнуться, как не сжечь деньги на подагентах и чем Hermes отличается от OpenClaw.

Что такое Hermes Agent

Агент делает Nous Research, код лежит в репозитории NousResearch/hermes-agent под лицензией MIT. На 10 ноября у репозитория 262 тысячи звёзд, а релиз v0.23.1 вышел в тот же день. У Hermes есть терминальный интерфейс и шлюз в мессенджеры: README перечисляет Telegram, Discord, Slack, WhatsApp, Signal и CLI в одном процессе.

Два свойства отличают его от обычного кодового агента. Он хранит память между сессиями и сам оформляет повторяющиеся процедуры в навыки (skills). Ещё он запускает изолированных подагентов и ведёт задачи по расписанию. Команды исполняются через один из шести терминальных бэкендов: local, Docker, SSH, Modal, Daytona или Vercel Sandbox.

Модель Hermes не содержит. README говорит, что подойдёт любая: Nous Portal, OpenRouter, OpenAI, собственный адрес и другие, а смена делается командой hermes model. Nous Portal это подписка самого проекта (300+ моделей и набор инструментов). Она не нужна, если у вас есть ключ с OpenAI-совместимым адресом, и Claudexia её не продаёт.

Установка на Windows, macOS, Linux и в Docker

Скрипт клонирует исходники, ставит менеджер uv и сам подтягивает Python 3.14, Node.js, ripgrep и FFmpeg. Системный Node и uv он не использует. На Windows права администратора не нужны: всё ложится в %LOCALAPPDATA%\hermes, а при отсутствии Git установщик кладёт собственный. Конвейер curl | bash выполняет чужой скрипт, поэтому сначала откройте его в браузере и прочитайте.

После установки перечитайте профиль оболочки (source ~/.bashrc или source ~/.zshrc) и запустите hermes. На Windows откройте новое окно PowerShell: PATH обновляется только для новых сессий, в старом окне команда не найдётся.

Windows без WSL

Нативный Windows поддерживается целиком: CLI, шлюз, TUI, cron, MCP и браузерный инструмент работают без WSL. Команды терминального инструмента Hermes выполняет через Git Bash, как и Claude Code. WSL2 берут, когда нужно окружение POSIX, и тогда данные лежат в ~/.hermes, а не в %LOCALAPPDATA%.

Одна неприятность из README: антивирус может отправить uv.exe из папки hermes\bin в карантин. Проект называет это ложным срабатыванием, потому что файл принадлежит Astral, и советует исключать папку, а не файл: хеш меняется с каждой версией.

Сервер и Docker

После мастера setup шлюз запускают в фоне:

docker run -d --name hermes --restart unless-stopped \
  -v ~/.hermes:/opt/data -p 8642:8642 \
  nousresearch/hermes-agent gateway run

Порт 8642 открывает OpenAI-совместимый API-сервер Hermes и нужен только панели или внешним инструментам. Документация прямо предупреждает, что открытый порт на машине в интернете это риск. Если пользуетесь одним Telegram, порт не публикуйте. Docker-установка не умеет hermes update: обновляются, запуская новый образ. README описывает и бюджетный сценарий: агент живёт на VPS за 5 долларов, а вы пишете ему из мессенджера.

Мастер настройки и первый запуск

На чистой установке hermes setup предлагает три режима. Quick Setup идёт через Nous Portal. Full Setup проводит по каждому провайдеру и инструменту, ключи вы приносите свои. Blank Slate оставляет включёнными только провайдера, файловые операции и терминал. Если на компьютере уже есть ~/.openclaw, ~/.claude, ~/.codex или ~/.cursor, мастер сначала предложит импортировать оттуда настройки.

Нам подходит Full Setup либо сразу hermes model. Секреты Hermes хранит в ~/.hermes/.env, остальные настройки в ~/.hermes/config.yaml. На Windows тот же каталог лежит в %LOCALAPPDATA%\hermes.

Ограничение, о котором стоит знать до выбора модели: Hermes требует окно не меньше 64 000 токенов. Модели поменьше отвергаются при запуске. Для облачных Claude, GPT, DeepSeek это не проблема, для локальных моделей окно нужно задавать явно.

Как подключить модель Claudexia

Claudexia даёт OpenAI-совместимый адрес и один ключ на все модели каталога. Оплата картой РФ, через СБП или криптой, пополнение от 1 доллара, VPN и аккаунт у вендора не нужны. Документация Hermes говорит, что подойдёт любой сервер с /v1/chat/completions, а именно так настроен наш гайд по Hermes, OpenClaw и SDK.

1. Зарегистрируйтесь, пополните баланс и создайте ключ sk_cdx_... в разделе «API-ключи» кабинета.
2. Выполните hermes model, выберите «Custom endpoint», введите адрес https://api.claudexia.tech/v1, ключ и имя модели. На вопрос о контексте ответьте числом, а не пустой строкой.
3. Либо впишите то же в config.yaml руками:

model:
  provider: custom
  default: gpt-6-astra
  context_length: 1000000
  base_url: https://api.claudexia.tech/v1
  api_mode: chat_completions
  api_key: sk_cdx_YOUR_KEY

4. Запустите hermes и дайте проверяемую задачу вроде «Summarize this repo in 5 bullets and tell me what the main entrypoint is». Команда hermes doctor покажет, чего не хватает.

Поля читаются так. provider: custom и base_url указывают на ваш адрес. В default стоит ID модели из каталога, список отдаёт GET /v1/models и страница моделей. Ключ не обязательно держать в файле: вместо api_key можно написать key_env: ИМЯ_ПЕРЕМЕННОЙ, и Hermes прочитает его из окружения.

Про context_length наш гайд говорит, что поле нужно. Причина видна в документации и исходниках Hermes: окно ищется по цепочке источников (значение в конфиге, кэш, ответ /models сервера, OpenRouter, models.dev), а если ничего не нашлось, берётся окно по умолчанию. В исходниках v0.23.1 это 256K, хотя страница документации всё ещё называет 128K, и модель с меньшим настоящим окном после этого упирается в ошибку API. Значение из config.yaml бьёт все остальные и помечается как pinned.

С api_mode проще. chat_completions подходит для текстовых моделей каталога, включая Claude, и с него лучше начинать. У моделей изображений и видео свои адреса (/v1/images/generations, /v1/videos), через чат-запросы они не работают. Для Claude гайд предлагает ещё anthropic_messages, но ни как писать адрес для этого режима, ни его поведение на Hermes мы не проверяли.

Один нюанс из документации. Команда /model внутри чата переключает только между уже настроенными провайдерами. Нового провайдера она не добавит: выйдите из сессии и выполните hermes model.

Конфиг взят из гайда Claudexia, а поддержку custom-провайдера подтверждает документация Hermes. Реальный запрос на v0.23.1 мы для этой статьи не гоняли, поэтому первый ответ проверьте сами.

Какую модель поставить

Прайс Claudexia (канал Premium) на 10 ноября 2026, актуальные цены смотрите на странице моделей:

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

Для пробы в каталоге на 10 ноября одна модель с нулевой ценой: deepseek-v4.1-flash-1017-free, контекст 1M. Это не Claude и не GPT. Условия и лимиты смотрите на странице моделей, а поле о поддержке вызова инструментов в каталоге у неё не заполнено, так что для агента это эксперимент. Подробнее про такой запуск в статье «Claude Code бесплатно».

Сколько тратит агент и как это ограничить

Chat Completions не хранит состояние, поэтому на каждом шаге агент заново отправляет модели системный промпт, описание инструментов, навыки, снимок памяти и историю. Сама память маленькая: по документации MEMORY.md ограничен 2 200 символами (около 800 токенов), USER.md 1 375 символами (около 500 токенов). Деньги уходят в другое.

• Сжатие истории. По умолчанию оно срабатывает на половине окна (compression.threshold: 0.50). При context_length: 1000000 это 500 тысяч токенов, и до тех пор объёмные выводы инструментов едут в каждом запросе. Документация советует попробовать proactive_prune_tokens: 48000: старые результаты инструментов сворачиваются без вызова модели. По умолчанию опция выключена.
• Фоновые задачи. Заголовки сессий, сжатие, разбор изображений и классификатор опасных команд идут на основную модель. Документация предупреждает, что на дорогой модели это заметная добавка, и предлагает переопределять auxiliary.<задача>.
• Подагенты. Они наследуют модель родителя. Параллельно по умолчанию работают до 3, глубина 1, но стоимость растёт кратно: при глубине 3 и ширине 3 дерево доходит до 27 листовых агентов.
• Потолок. agent.max_turns по умолчанию без ограничений. Число в конфиге поставит потолок на шаги за один ход.

Дешёвую модель для фона и подагентов задают так:

auxiliary:
  compression:
    model: deepseek-v4.1-flash
    base_url: https://api.claudexia.tech/v1
    api_key: sk_cdx_YOUR_KEY

delegation:
  model: deepseek-v4.1-flash
  base_url: https://api.claudexia.tech/v1
  api_key: sk_cdx_YOUR_KEY

Автоматическое кэширование промпта Hermes включает для Claude на родном Anthropic, OpenRouter и Nous Portal. О собственном адресе документация молчит, так что экономию от кэша не закладывайте. Расход смотрите командами /usage и /insights --days 7, а в кабинете Claudexia расход виден по каждому ключу. Общие приёмы экономии описаны в статьях «Как урезать счёт за Claude Code» и «Счета за ИИ-агентов растут». Пока тестируете, держите на балансе небольшую сумму и выпустите под агента отдельный ключ.

Hermes или OpenClaw

Сравнение по документации самого OpenClaw мы уже разбирали в статье про OpenClaw, здесь его не повторяем. Практическая разница в другом: Hermes умеет забрать ваши настройки. Команда hermes import-agent openclaw --dry-run покажет, что переедет: персона SOUL.md, записи памяти, пользовательские навыки, список разрешённых команд и настройки мессенджеров. Ключи API переносятся только с флагом --migrate-secrets. Для Claude Code, Codex CLI и Cursor команда та же, меняется последнее слово.

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

Безопасность

Hermes проверяет команды по списку опасных шаблонов. Режим approvals.mode: smart стоит по умолчанию: вспомогательная модель оценивает риск, безобидные команды проходят, опасные блокируются, сомнительные уходят вам на подтверждение. Режим manual спрашивает всегда. Режим off равен флагу --yolo и снимает все проверки, поэтому годится только для изолированной среды вроде контейнера.

Изоляцию даёт терминальный бэкенд: hermes config set terminal.backend docker. В мессенджерах работают сопряжение и список разрешённых пользователей. Что нельзя отправлять модели в любом случае, разобрано в статье «Что нельзя отправлять в языковую модель».

Если что-то не работает

Если ничего из таблицы не подошло, hermes doctor называет недостающее, а hermes --continue возвращает последнюю сессию, чтобы проверить сохранение.

FAQ

Как установить Hermes Agent на Windows?

В PowerShell выполните iex (irm https://hermes-agent.nousresearch.com/install.ps1), права администратора не нужны. Затем откройте новое окно терминала и запустите hermes. Есть и приложение Hermes Desktop: MSIX-пакет требует Windows 11 22H2 или новее. Для POSIX-окружения подойдёт установка внутри WSL2 той же командой, что на Linux.

Hermes Agent бесплатный?

Сам агент да: лицензия MIT, подписки на него нет. Платите за токены модели. Nous Portal это отдельная подписка проекта, она необязательна. В каталоге Claudexia есть одна бесплатная модель для пробы, deepseek-v4.1-flash-1017-free, условия и лимиты на странице моделей.

Как подключить свою модель или API-ключ к Hermes Agent?

Выполните hermes model и выберите Custom endpoint либо впишите блок model с provider: custom, base_url, api_key и context_length в ~/.hermes/config.yaml. Готовый пример для Claudexia приведён выше. Смена модели без смены провайдера делается командой /model в чате.

Hermes Agent на сервере: как запустить?

Самый простой путь Docker: setup в интерактивном режиме, потом gateway run в фоне с томом ~/.hermes:/opt/data. Подключите Telegram через hermes gateway setup. Порт 8642 публиковать нужно, только если вам нужна панель или внешний доступ к API-серверу.

Чем Hermes Agent отличается от OpenClaw?

OpenClaw это Gateway, который связывает чаты с агентом, Hermes это платформа личного агента с CLI, памятью, навыками и подагентами. Что переедет при миграции, показывает hermes import-agent openclaw --dry-run. Таблица различий лежит в статье про OpenClaw.

Как сменить модель в Hermes Agent?

Если провайдер уже настроен, введите /model в чате. Для нового провайдера выйдите из сессии и выполните hermes model. Подагентам и фоновым задачам модель задают отдельно, блоками delegation и auxiliary в config.yaml.