Hermes Agent: установка и настройка по шагам

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

Ниже установка и настройка Hermes Agent в том порядке, в котором я бы делал её сейчас с нуля. Команды сверены с официальной документацией на 22.10.2026. Hermes обновляется часто, поэтому если команда не сработала, сначала загляните в раздел установки на сайте проекта.

Что такое Hermes Agent

Hermes Agent это открытый ИИ-агент от Nous Research. Он из той же категории, что Claude Code и Codex: агент получает задачу, сам вызывает инструменты (терминал, файлы, поиск, браузер) и доводит работу до результата.

Чем он отличается от соседей:

Модель на выбор. Claude, GPT, DeepSeek, локальная модель, свой шлюз. Нужен контекст не меньше 64 000 токенов: модели с окном меньше Hermes не принимает. Модель меняется одной командой, остальная настройка остаётся.
Живёт в мессенджерах. Тот же агент со всеми инструментами отвечает в Telegram, Discord, Slack, WhatsApp и ещё десятке площадок.
Навыки и память. Удачный способ решить задачу агент сохраняет как навык (skill) и подгружает в следующих сессиях. Отдельно он помнит факты о вас и вашем окружении.
Расписание. Задачи по cron: каждое утро, раз в час, один раз через 36 часов.

Установка Hermes Agent

Mac и Windows: приложение

Самый простой путь: скачать установщик на сайте hermes-agent.nousresearch.com. В пакете уже есть агент, Python и всё нужное, собирать ничего не придётся.

Учтите: установщик для macOS работает только на Apple Silicon. На Маке с Intel официальной поддержки нет.

Только терминал: Linux, macOS, WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc   # или source ~/.bashrc

Windows без WSL

В PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Что ставит скрипт

На Linux, macOS и в WSL2 скрипт раскладывает файлы так:

код в ~/.hermes/hermes-agent/;
команду hermes в ~/.local/bin/;
ваши данные (настройки, сессии, навыки, память) в ~/.hermes/;
свои версии Python, Node.js, ripgrep и FFmpeg, плюс инструменты браузера.

В Windows без WSL код лежит в %LOCALAPPDATA%\hermes\hermes-agent\, команда запуска в %LOCALAPPDATA%\hermes\bin\, данные в %LOCALAPPDATA%\hermes\.

Если браузер агенту не нужен, его можно не ставить:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser

У установщика для PowerShell этот параметр называется -SkipBrowser. Выбор сохраняется, и hermes update браузер обратно не притащит.

Обновление: hermes update. Удаление: hermes uninstall.

Терминал говорит hermes: command not found? Значит, оболочка ещё не перечитала настройки. Откройте новое окно терминала или выполните source из блока выше.

Настройка Hermes Agent: выбор модели

Это главный шаг. Всё остальное можно докрутить потом, а без рабочей модели агент молчит.

hermes setup

Мастер предложит три режима:

Quick Setup. Вход через Nous Portal, одна подписка на модели и встроенные инструменты: поиск, генерацию картинок, озвучку. Ключи вводить не нужно.
Full Setup. Проходите все настройки сами и подключаете свои ключи.
Blank Slate. Минимум: модель, файлы и терминал. Всё остальное выключено, включаете только то, что нужно.

Если провайдер уже выбран, хватит одной команды:

hermes model

Варианты, которыми пользуются чаще всего:

OpenAI Codex. Подписка ChatGPT, вход по коду с устройства.
Anthropic. Модели Claude по API-ключу с отдельной оплатой. Есть и вход через аккаунт, но только с подпиской Claude Max и купленными дополнительными кредитами (extra usage): Hermes тратит их, а не лимит подписки. С Claude Pro такой вход не работает.
OpenRouter. Один ключ на много моделей.
Свой адрес (custom endpoint). Любой сервер, совместимый с API OpenAI, в том числе локальная модель.

У меня основной агент работает на Claude Opus через собственный шлюз, а дочерние задачи и проверки идут на GPT по подписке ChatGPT. Так Claude пишет, а модель другой семьи проверяет.

Где что хранится (пути для Linux и macOS):

API-ключи и токены интеграций в ~/.hermes/.env;
данные входа через аккаунт (Nous Portal, OpenAI Codex) в ~/.hermes/auth.json;
остальные настройки в ~/.hermes/config.yaml.

Руками в файлы лезть необязательно. Команда hermes config set сама кладёт значение в нужный файл:

hermes config set terminal.backend local

Команды агента выполняются прямо на вашей машине (local). Если Docker уже установлен и запущен, их можно увести в контейнер: hermes config set terminal.backend docker. Делайте это после первой проверки, а не до неё.

Первая проверка

hermes          # классический интерфейс
hermes --tui    # новый интерфейс

Дайте задачу, результат которой легко проверить. Например: «Посмотри текущую папку и скажи, какой файл тут главный».

Всё работает, если:

в шапке видно выбранную модель;
агент отвечает без ошибок;
он вызывает инструмент, когда это нужно (терминал, чтение файла);
разговор продолжается дольше одного сообщения.

Потом проверьте, что сессия сохранилась:

hermes -c   # вернуться в последнюю сессию

Моё правило, и в документации оно такое же: пока агент не провёл один нормальный разговор, Telegram, расписание и навыки не подключать. Иначе непонятно, где именно сломалось.

Подключение Telegram

hermes gateway setup

Понадобятся токен бота от @BotFather и ваш ID в Telegram, чтобы бот отвечал только вам. После настройки:

hermes gateway install   # запуск как фоновой службы
hermes gateway status    # проверить, что работает

Дальше начинается самое полезное. Один бот может вести себя по-разному в разных топиках группы.

Сначала добавьте бота в группу с включёнными топиками. По умолчанию у ботов Telegram включён privacy mode, и в группе бот видит только обращения к себе через @имя_бота и команды. Чтобы он читал все сообщения, отключите privacy mode в @BotFather (команда /setprivacy) или назначьте бота администратором. После смены privacy mode удалите бота из группы и добавьте заново.

Теперь в config.yaml для каждого топика задаётся своя инструкция:

telegram:
  channel_prompts:
    "14862": |
      Ты дизайнер. Делаешь обложки и макеты, отвечаешь по-русски.

Номер в кавычках это ID топика (message_thread_id), не ID всей группы. Так у меня устроена вся команда: бот один, топиков 18, роли разные. Отдельные профили с собственными ключами и памятью нужны, только когда агентов надо по-настоящему изолировать друг от друга.

Что я подключил потом

Навыки. У меня их 204: от монтажа видео до SEO-аудита. Найти и поставить готовый навык можно командами hermes skills search и hermes skills install.
Память. Хранится на моём сервере. Встроенная память агента маленькая: в моей настройке лимит 2200 символов на заметки и 1375 на профиль. Поэтому туда идут только факты, которые нужны в каждой сессии.
Расписание. Сейчас крутятся 7 задач. Одна из них каждую ночь в 04:15 делает зашифрованный бэкап кабинета статей, при успехе молчит и пишет в Telegram, только если что-то сломалось.
Подтверждение команд. По умолчанию работает режим smart: вспомогательная модель оценивает риск команды, безопасные пропускает, явно опасные запрещает, а спорные передаёт человеку. Я переключил на ручной режим hermes config set approvals.mode manual: команду, которую Hermes считает опасной, вроде rm -rf, агент без моего «да» не выполнит. Режим --yolo, который отключает подтверждения, я не включаю.

Частые ошибки при настройке Hermes Agent

Агент отвечает пусто или с ошибкой. Почти всегда дело в провайдере: неверный ключ, модель или вход. Запустите hermes model и пройдите выбор заново.
Свой адрес модели «работает», но отвечает мусором. Проверьте адрес, имя модели и совместимость с API OpenAI в отдельном клиенте.
Бот в Telegram молчит. Проверьте токен, свой ID в списке разрешённых и hermes gateway status.
hermes -c не находит старую сессию. Скорее всего, вы в другом профиле. Посмотрите hermes sessions list.
Из России не отвечает Claude или GPT. Anthropic и OpenAI ограничивают доступ из России. У меня трафик Мака идёт через VPN.

Когда непонятно, что сломалось, проверяю по порядку:

hermes doctor
hermes model
hermes setup
hermes sessions list
hermes -c
hermes gateway status

hermes doctor чаще всего сразу говорит, чего не хватает.

С чего начать

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

Как разложить для агента правила проекта и память, чтобы не повторять их в каждом сообщении, я разобрал в статье про контекст ИИ-агента. Как Hermes работает в паре с Codex, в разборе про управление несколькими агентами.

Hermes Agent: установка и настройка, как я завёл его на Mac и в Telegram