Настройка Hermes: модель, бэкенд, инструменты Настройка

Настройка Hermes: модель, бэкенд, инструменты

Скопируй страницу и вставь в Claude или GPT — разберёт под твою задачу.

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

Короткий ответ

После установки пройди три команды-мастера по очереди: hermes model (какая LLM думает), hermes tools (шлюз в мессенджер плюс браузер, картинки, голос, веб-поиск) и один раз загляни в config.yaml, чтобы развести вспомогательные роли по дешёвым моделям. Логинься не по сырому API-ключу, а через подписку — например, вход «OpenAI ▸ Codex CLI» даёт GPT-5.5 по подписке Codex. Тяжёлый код отдавай командами /claude_code и /codex напрямую в их CLI, минуя основную модель.

Что уже должно быть

  • Установленный Hermes — команда hermes доступна, базовый hermes setup пройден.
  • Активная подписка на LLM-провайдера: сессия Claude Code или Codex, через которую можно залогиниться по OAuth, без отдельного платного ключа.
  • Аккаунт в Telegram для шлюза — самый простой канал связи с агентом.
  • По желанию — ключи или подписки под конкретные инструменты (веб-поиск, X-поиск), но на старте они не обязательны.

Модель: какой мозг думает

Выбор провайдера — первое реальное решение. Управляется командой:

hermes model

Главное правило — предпочитай вход по подписке, а не по сырому API-ключу. Ключ тарифицируется за каждый токен, подписка — фиксированной суммой в месяц. Если у тебя уже есть сессия Claude Code или Codex, залогинься через неё. Пункт «OpenAI ▸ Codex CLI», например, отдаёт GPT-5.5 по той же подписке Codex — отдельно платить не надо.

Дальше — тонкость, которая экономит больше всего. Hermes разделяет модель ОСНОВНОГО диалога и модели для ВСПОМОГАТЕЛЬНЫХ задач. По умолчанию одна модель тянет и то, и другое, но каждую служебную роль можно увести на свою модель в config.yaml. Ролей больше десятка, вот основные:

vision            — анализ изображений
web_extract       — пересказ длинных веб-страниц
compression       — сжатие переполненного диалога
title_generation  — генерация заголовков
curator           — фоновый агент самообучения
kanban_decomposer — разбивка крупных задач
СОВЕТ. Уведи дешёвые роли — заголовки, сжатие, извлечение текста — на маленькую быструю модель, а сильную оставь только под основной диалог. Качество ответов не падает, а расход режется заметно, потому что 90% служебных вызовов — это тривиальщина, которой флагман не нужен. Код при этом не страдает: команды /claude_code и /codex отдают задачу прямо в эти CLI, так что кодовое качество держится даже на бюджетной модели диалога.

Терминал-бэкенд: где выполняются команды

Второй узел — где именно агент запускает команды. Вариантов пять:

БэкендЧто этоКогда брать
Local (по умолчанию) Запуск на твоей машине под твоим пользователем, без изоляции Доверенный личный сервер — большинству этого хватает
Docker Изолированная песочница, до хоста не дотянется Недоверенный код, который не жалко запереть
SSH Команды и файлы на удалённом сервере по соединению Агент управляет другой машиной
Modal Бессерверные облачные песочницы Разовые задачи без своей инфраструктуры
Daytona Контейнерный слой под AI-кодеров, быстрее голого Docker, сам поднимает окружение Командная работа, много параллельных сборок

Local безопасен не за счёт изоляции, а за счёт встроенной системы подтверждений: она перехватывает разрушительные команды вроде rm -rf / или DROP TABLE и спрашивает разрешения, прежде чем выполнить.

ВНИМАНИЕ. У Local нет изоляции — агент работает с правами твоего пользователя и видит весь хост. Держи его только на доверенном сервере, где ты сам контролируешь, что запускается. Гоняешь чужой или непроверенный код — переключайся на Docker или SSH, чтобы ошибка агента осталась в песочнице, а не легла на боевую машину.

Шлюз и инструменты

Третий узел — как с агентом разговаривать и что он умеет наружу. Команда:

hermes tools

Самый простой шлюз — Telegram. Можно взять готового бота по ссылке или поднять своего через токен от BotFather. В том же мастере включаются инструменты: автоматизация браузера, генерация картинок, речь, веб-поиск. Под веб-поиск можно поднять свой Firecrawl или подключить Exa. Генерацию картинок тоже реально завести по подписке — пункт «OpenAI (Codex auth)» даёт gpt-image-2 через ту же подписку Codex — без отдельного API-ключа и без пооплаты за каждую картинку, в пределах лимитов подписки. А вот X-поиск требует подписки Grok — полезно знать заранее, чтобы не искать бесплатный путь.

Slash-команды, которые стоит знать

Полный список — hermes skills (или /commands прямо в чате); каждый скилл доступен как /<имя-скилла>. Ключевые:

  • /background <промпт> — запускает задачу в фоне, не прерывая текущую сессию.
  • /goal — ставит долгую цель, которую агент преследует настойчиво (с pause / resume / clear / status); /subgoal дробит её на подцели.
  • /kanban — оркестрирует длинную асинхронную работу по нескольким независимым агентам, как доска, раздающая задачи исполнителям.
  • /github_pr_workflow (ветка → merge с CI), /github_code_review, /codebase_inspection — для разработки.
  • /notion, /obsidian, /youtube_content и другие — интеграции с внешними сервисами.

Cron и вебхуки

Cron запускает скрипт по расписанию. Важный флаг — --no-agent: с ним Hermes выполняет обычный Python- или bash-скрипт и просто пересылает результат, НЕ тратя токены модели. Гонять простой скрипт через агента — сжигать деньги впустую.

Вебхуки — это реакция на внешнее событие вместо таймера. Пришёл новый PR на GitHub — сработал вебхук — агент сам запустил ревью. Расписание для регулярного, вебхуки для событийного.

Частые ошибки

СимптомПричинаЧто сделать
Счёт за токены растёт непонятно от чего Вход по сырому API-ключу — тарификация за каждый вызов Залогинься через подписку (OAuth Codex/Claude) в hermes model
Токены тают на мелочах — заголовках, сжатии Все вспомогательные роли сидят на флагманской модели Разведи служебные роли в config.yaml на дешёвую быструю модель
X-поиск не работает Он требует отдельной подписки Grok Подключи Grok или не рассчитывай на этот инструмент
Простой скрипт по крону жжёт токены Cron-задача идёт через агента Создай задачу с флагом --no-agent — скрипт без модели

Итог

Рабочий агент собирается из четырёх решений. Модель — вход по подписке через hermes model, не по сырому ключу. Роутинг — тяжёлый диалог на сильной модели, служебные роли в config.yaml на дешёвой, код через /claude_code и /codex. Бэкенд — Local на доверенном сервере, Docker или SSH для чужого кода. Шлюз и инструменты — Telegram плюс браузер, картинки, веб-поиск через hermes tools, с оглядкой на то, что X-поиску нужен Grok. А фон и расписание — /background, cron с --no-agent и вебхуки, чтобы не платить за то, что модель делать не должна.

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

FAQ

Как в Hermes сэкономить токены?

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

Какие бэкенды выполнения команд есть в Hermes?

Пять: Local (по умолчанию, без изоляции, для доверенного сервера), Docker (изолированная песочница), SSH (команды на удалённой машине), Modal и Daytona (облачные песочницы). Для чужого или непроверенного кода бери Docker или SSH.

Как запускать cron-скрипт в Hermes без траты токенов?

Создавай задачу с флагом --no-agent — тогда Hermes выполнит обычный Python- или bash-скрипт и перешлёт результат, не задействуя модель. Гонять простой скрипт через агента — сжигать деньги впустую.