Настройка
Настройка 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-скрипт и перешлёт результат, не задействуя модель. Гонять простой скрипт через агента — сжигать деньги впустую.