Помощник Hermes AI: установка, настройка, рабочий процесс и устранение неполадок

Hermes Agent — это хостящийся на собственном сервере (self-hosted), независимый от конкретной модели искусственный интеллект, который работает на локальной машине или недорогом VPS, взаимодействует через терминал и мессенджеры, а также совершенствуется со временем, превращая повторяющиеся задачи в повторно используемые навыки.

По функциональности он очень похож на OpenClaw, другую самохостящуюся платформу ассистентов, построенную вокруг инструментов, памяти и локального контроля. Многие разработчики обратились к Hermes после того, как Anthropic заблокировала доступ к подписке Claude для OpenClaw в апреле 2026 года — хронология роста и падения OpenClaw объясняет, почему Hermes стал естественным выбором для пользователей, желающих постоянной, самохостящейся автоматизации без зависимости от провайдера.

Если вам нужна более широкая картина самохостящихся ассистентов, поиска и локальной инфраструктуры вокруг Hermes, этот обзор систем ИИ связывает эти темы с теми проблемами, которые решает Hermes.

Для оценки компромиссов при развертывании и выбора среды выполнения хостинг LLM в 2026 году: локальный, самохостящийся и облачная инфраструктура предоставляет карту хостинга, а производительность LLM в 2026 году: бенчмарки, узкие места и оптимизация охватывает аспекты пропускной способности и задержки после запуска Hermes. Для компактной карты команд оболочки (hermes gateway, hermes memory, hermes doctor, слэш-команды и другие) используйте [шпаргалку CLI Hermes Agent](https://www.glukhov.org/ru/ai-systems/hermes/hermes-agent-cli-cheatsheet/ “Быстрая справка по CLI Hermes Agent — установка, hermes chat, gateway, skills, memory, диагностика и слэш-команды.”}).

Моя предвзятая точка зрения: Hermes наиболее интересен, когда его рассматривают как инфраструктуру, а не как вкладку, которую вы открываете изредка. Как только он запущен как служба и имеет стабильный домашний каталог, ваши промпты начинают напоминать не «чат», а «операционные задачи» (ops).

Что такое Hermes Agent и почему это важно

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

Два дизайнерских решения стоит прояснить, так как они определяют всё остальное в этом руководстве.

Во-первых, Hermes не привязан к одному провайдеру моделей. Официальный процесс настройки поддерживает несколько провайдеров и любой конечный узел, совместимый с OpenAI, а переключение осуществляется через команду hermes model, а не путем редактирования кода.

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

Стоимость и лицензирование приятно просты. Сам Hermes Agent является бесплатным программным обеспечением под лицензией MIT. Если вы используете размещенные модели, постоянная стоимость — это то, что взимает ваш провайдер. Если вы запускаете локальные модели, вы можете полностью избежать платы за API.

Если ваша настройка Hermes использует Claude через внешние слои инструментов, это изменение в подписке Anthropic является полезным справочным материалом о том, почему тарификация на основе API теперь является ожидаемым путем.

Установка Hermes Agent

У Hermes есть быстрый путь установки для Linux, macOS и WSL2. Официальная документация сохраняет всё намеренно простым.

Установка Hermes на Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

После установки перезагрузите оболочку и запустите CLI.

source ~/.bashrc   # или source ~/.zshrc
hermes

Установщик — это не просто тонкая обертка. Согласно руководству по установке, он настраивает зависимости, репозиторий, виртуальное окружение и команду hermes, приводя вас к первому состоянию, готовому к чату.

Примечания по Windows и Android

Нативная Windows не поддерживается. В документации рекомендуется использовать WSL2 и запускать Hermes внутри него.

Для Android Hermes поддерживает путь установки через Termux. Он разработан так, чтобы обнаруживать Termux и соответствующим образом адаптировать настройку зависимостей и окружения.

Быстрый старт

Самый быстрый первый запуск — это буквально просто hermes, но осмысленный быстрый старт означает два дополнительных решения: какой провайдер моделей использовать и какие инструменты следует включить.

Выберите провайдера и модель

Hermes предоставляет три взаимодополняющие точки входа:

• hermes model для выбора провайдера и модели по умолчанию
• hermes tools для включения или отключения наборов инструментов
• hermes setup для запуска интерактивного мастера по основным областям конфигурации

Минимальный поток выглядит так:

hermes model
hermes tools
hermes

Что касается того, что действительно поддерживается, официальный Quickstart перечисляет ряд провайдеров и также указывает, что Hermes работает с API, совместимыми с OpenAI. Это важно, потому что это включает как размещенные сервисы, так и самохостящиеся конечные точки.

Докажите выполнение инструментов на раннем этапе

Прежде чем вы начнете формировать привычки вокруг Hermes, стоит проверить, что использование инструментов работает в вашем окружении. Quickstart явно предлагает использование терминала как первую функцию для проверки.

На практике небольшой промпт-«тест на дым» выполняет две задачи: он проверяет инструмент терминала и валидирует запросы разрешений.

Пример промпта:

Покажи использование диска и пять самых больших директорий.

Если Hermes не может запустить инструмент терминала, пропустите раздел к Устранению неполадок. Неправильная конфигурация бэкэнда терминала — одна из самых распространенных причин, и исправление обычно становится очевидным, как только вы посмотрите на конфигурацию.

Конфигурация, масштабируемая на будущее

Hermes вознаграждает тех, кто понимает, где он хранит состояние и как разрешает конфигурацию. Это также место, откуда возникает множество проблем «работало вчера».

Где живут конфигурация и состояние

Hermes хранит свои настройки и состояние в ~/.hermes. Официальное руководство по конфигурации документирует структуру, включая config.yaml для настроек, .env для секретов, auth.json для учетных данных OAuth, SOUL.md для идентичности, а также папки для памяти, навыков, cron, сессий и логов.

Это важно по двум причинам.

• Отладка становится механической, потому что вы знаете точно, куда смотреть.
• Резервное копирование становится простым, потому что одна директория захватывает большую часть состояния агента, которое вас интересует.

Приоритет конфигурации и сохранение секретов вне config.yaml

Hermes разрешает конфигурацию с порядком приоритета. На вершине находятся переопределения CLI, затем config.yaml, затем .env, со встроенными значениями по умолчанию внизу.

Позитивная деталь в том, что hermes config set направляет значения в правильный файл: API-ключи в .env, а несекретные настройки — в config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes также поддерживает подстановку переменных окружения внутри config.yaml через синтаксис ${VAR_NAME}. Это полезно, когда вы хотите сохранить определенные значения в окружении, одновременно ссылаясь на них в структурированной конфигурации.

Песочница и бэкэнды выполнения

Hermes поддерживает несколько бэкэндов терминала, которые определяют, где фактически выполняются команды оболочки. Руководство по конфигурации перечисляет local, docker, ssh, modal, daytona и singularity.

Мнение, которое можно выразить без фанатизма:

• local — самый быстрый и простой, но он не изолирован
• docker — прагматичный слой безопасности и воспроизводимости
• ssh — чистый способ разделения устройства чата и вычислительного узла
• modal и daytona подходят для рабочих процессов «бессерверных, но достаточно постоянных»
• singularity — вариант, дружелюбный к HPC (высокопроизводительным вычислениям)

Минимальный пример бэкэнда Docker:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

В документации также описано усиление безопасности для бэкэнда Docker, такое как снижение привилегий (dropping capabilities) и отключение эскалации привилегий.

Навыки, память и профили

У Hermes есть два связанных механизма для накопления ценности.

Навыки — это процедурная память. Hermes может создавать, обновлять и удалять свои собственные навыки и может предложить сохранить подход как навык после выполнения сложной задачи.

Встроенная память хранится в виде файлов, таких как MEMORY.md и USER.md, в ~/.hermes, и Hermes также может использовать внешние провайдеры памяти для более глубокого воспоминания. Документация по памяти перечисляет несколько плагинов провайдеров, а руководство по провайдерам памяти документирует интерактивный процесс настройки. Для полного технического разбора того, как работает архитектура памяти — замороженные снимки, лимиты символов, восемь внешних провайдеров и философия заграниченной памяти — см. [Система памяти Hermes Agent: как на самом деле работает постоянная память ИИ](https://www.glukhov.org/ru/ai-systems/hermes/hermes-agent-memory-system/ “Глубокое техническое руководство по архитектуре памяти Hermes Agent — от ограниченной двухфайловой основной памяти до 8 подключаемых внешних провайдеров.”}).

Если вам нужно несколько независимых агентов на одной машине, профили Hermes обеспечивают изоляцию. Каждый профиль получает собственную директорию со своей конфигурацией, секретами, памятью, сессиями, навыками, заданиями cron и состоянием шлюза.

Для более глубокого взгляда на то, какие навыки хорошо работают в продакшене по ролям — инженеры, исследователи, операторы и исполнительные рабочие процессы — см. [Навыки ИИ-ассистента Hermes для реальных производственных настроек](https://www.glukhov.org/ru/ai-systems/hermes/production-setup/ “Руководство по профилям для конфигурации и навыков Hermes Agent для инженеров, исследователей, операторов и исполнительных рабочих процессов в продакшене.”}). Когда вы будете готовы создавать или отлаживать сами файлы SKILL.md — метаданные YAML, уровни прогрессивного раскрытия, условная видимость и установка из хабов — используйте [Авторство навыков Hermes Agent — структура SKILL.md и лучшие практики](https://www.glukhov.org/ru/ai-systems/hermes/authoring-hermes-skill/ “Создание навыков Hermes с YAML-фронтоматтером, прогрессивным раскрытием, условной активацией, секретами против конфигурации и устранением неполадок с индексом.”}).

Типичный рабочий процесс

Если вы относитесь к Hermes как к агенту, который вы будете использовать постоянно, рабочий процесс начинает напоминать инженерное обслуживание сервисов.

Стабильная базовая линия

Базовая линия, которая склонна не деградировать:

1. Установите и запустите первый чат в CLI.
2. Выберите провайдера и модель с помощью hermes model, затем подтвердите стоимость.
3. Настройте наборы инструментов и решите, будет ли выполнение терминала локальным или в песочнице.
4. Внесите быстрое изменение в SOUL.md только после того, как вы использовали настройки по умолчанию какое-то время. Изменения идентичности важнее, чем люди ожидают, потому что это «слот 1» в системном промпте.

Ежедневное использование, которое накапливает ценность

У Hermes есть терминальный интерфейс, а не веб-интерфейс, и он разработан для длинных сессий со слэш-командами, возобновляемыми сессиями и потоковым выводом инструментов.

На практике полезный ритм:

• выполнять работу в именованной сессии для проекта
• сжимать контекст, когда он становится слишком большим
• позволять Hermes превращать повторяющиеся рутины в навыки
• держать ментальную границу между «спросить» и «сделать», чтобы выполнение инструментов оставалось аудируемым

Шлюз мессенджеров для доступа 24/7

Шлюз мессенджеров — это часть, которая заставит Hermes чувствовать себя ассистентом, а не приложением терминала. В документации он описывается как единый процесс, который подключается к нескольким платформам, обрабатывает сессии, запускает задания cron и доставляет сообщения.

Настройка вызывается через hermes gateway setup, и шлюз может работать в переднем плане или как служба пользователя. Справочник CLI документирует подкоманды шлюза, такие как run, install, start, stop, status и restart.

Для многоагентных бэклогов и контролируемого планирования см. Kanban в Hermes Agent для самохостящихся рабочих процессов LLM, который охватывает ограничения диспетчера, цепочки зависимостей и пакетную обработку на основе cron.

Безопасность для бота, использующего инструменты, имеет значение. Документация шлюза описывает списки разрешений для конкретных платформ и поток паринга в личных сообщениях (DM), который выдает одноразовые коды паринга и требует одобрения через hermes pairing approve.

Обновления без драмы

Обновления Hermes — это команда первого класса. Руководство по обновлению документирует hermes update, проверки миграции конфигурации и небольшой процесс пост-обновления валидации, включая hermes doctor и hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Устранение неполадок и диагностика

Большинство сбоев Hermes не таинственны. Они кажутся таинственными, потому что люди проверяют только слой модели и игнорируют слой времени выполнения.

Быстрые команды для сортировки

Справочник CLI явно позиционирует три команды как основной цикл:

• hermes doctor для интерактивной диагностики
• hermes status для быстрого обзора
• hermes dump для общего, очищенного от чувствительных данных сводного отчета о настройке

Для логов hermes logs выводит файлы, хранящиеся в ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Частые сбои при установке

FAQ и руководство по устранению неполадок перечисляют несколько повторяющихся проблем и их исправлений, включая проблемы с версией Python, отсутствие uv и проблемы с разрешениями, вызванные смешением установок от sudo и от имени пользователя.

Если вы столкнетесь с этими ошибками, документация предоставляет конкретные шаги по устранению, такие как обновление Python, установка uv и переустановка Hermes без sudo.

Проблемы с провайдерами и моделями

Когда API-ключи не работают, FAQ рекомендует проверить конфигурацию, повторно запустить hermes model или установить ключ напрямую через hermes config set. Также отмечается распространенная ловушка: ключи специфичны для провайдера.

Для проблем «модель не найдена» FAQ указывает обратно на использование hermes model для выбора действительного идентификатора и показывает как конфигурационные, так и пер-сессийные переопределения.

Также охвачены проблемы с ограничением скорости и длиной контекста. FAQ предлагает ждать ошибок 429, переключать провайдеров или модели и снижать давление контекста путем сжатия или новой сессии.

Проблемы с бэкэндом терминала и шлюзом

Если команды терминала немедленно терпят неудачу, руководство по конфигурации включает раздел «частые проблемы бэкэнда терминала» и указывает на типичные причины для каждого бэкэнда, включая неработающий Docker и отсутствующие переменные SSH. Также отмечается, что возврат к локальному режиму является допустимым шагом отладки, когда конфигурация песочницы вызывает сомнения.

Для проблем со шлюзом руководство по мессенджерам выделяет списки разрешений и паринг как безопасные значения по умолчанию, что означает, что многие инциденты «бот молчит» на самом деле являются результатом работы авторизации.

Ссылки

• Hermes Agent Homepage
• Система памяти Hermes Agent: как на самом деле работает постоянная память ИИ
• Навыки ИИ-ассистента Hermes для реальных производственных настроек