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

Hermes Agent — это самоуправляемый AI-ассистент, не привязанный к конкретной модели, работающий на локальном компьютере или недорогом VPS. Он функционирует через терминал и мессенджеры и со временем совершенствуется, превращая повторяющиеся задачи в переиспользуемые навыки.

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

Если вам нужен более широкий взгляд на самоуправляемых ассистентов, поиск (retrieval) и локальную инфраструктуру вокруг Hermes, этот обзор AI-систем связывает эти темы с теми же проблемами, которые решает Hermes. Чтобы изучить пятиуровневую модель ассистента — LLM, память, инструменты, маршрутизация и наблюдаемость — с Hermes и OpenClaw в качестве эталонных реализаций, смотрите [Архитектура AI-ассистентов](https://www.glukhov.org/ru/ai-systems/architecture/ai-assistant-architecture/ “Глубокое техническое руководство по архитектуре AI-ассистентов: LLM, память, инструменты, маршрутизация и наблюдаемость, с реальными компромиссами, режимами отказа и паттернами проектирования.”}. Для конкретных данных об использовании — звёзды GitHub, суточный объём токенов OpenRouter, количество загрузок с PyPI, история CVE и настроения сообщества в Reddit — OpenClaw vs Hermes Agent: Звёзды, Загрузки и Использование в 2026 отслеживает, как Hermes соотносится с 19 альтернативами по каждому измеряемому показателю.

Для понимания компромиссов при развёртывании и выборе среды выполнения, Размещение LLM в 2026 году: Сравнение локальных, самоуправляемых и облачных инфраструктур предоставляет карту размещений, а Производительность LLM в 2026: Бенчмарки, Узкие места и Оптимизация охватывает аспекты пропускной способности и задержки после запуска Hermes. Если вы регулярно используете Qwen или Gemma на локальных средах выполнения, таких как Ollama, объедините пресеты температуры и штрафов для многошагового использования инструментов в [Параметры inference для агентных LLM: Qwen и Gemma](https://www.glukhov.org/ru/llm-performance/benchmarks/agentic-inference-parameters-reference/ “Курируемая справочная коллекция параметров inference от вендоров и сообщества для Qwen 3.6 и Gemma 4, оптимизированных для агентных рабочих процессов и реальных систем кодирования.”}. Для компактной карты команд в shell (hermes gateway, hermes memory, hermes doctor, slash-команды и другое) используйте [Шпаргалка по CLI Hermes Agent](https://www.glukhov.org/ru/ai-systems/hermes/hermes-agent-cli-cheatsheet/ “Быстрый справочник по CLI Hermes Agent — установка, hermes chat, gateway, навыки, память, диагностика и slash-команды.”}. Если ваш основной вход — это мессенджеры на мобильном устройстве, используйте Голосовое управление Hermes со смартфона для настройки голосового стека и специфичных для платформ настроек.

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

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

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

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

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

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

Стоимость и лицензирование приятно скучны. Сам 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, после чего приводит вас к первому чат-готовому состоянию.

Если вы приходите из существующего развертывания OpenClaw, а не начинаете с чистого листа, сначала установите и проверьте пустой Hermes, а затем следуйте поэтапному переходу в [Как безопасно мигрировать из OpenClaw в Hermes Agent](https://www.glukhov.org/ru/ai-systems/hermes/migrate-from-openclaw/ “Миграция из OpenClaw в Hermes Agent с проверками в режиме dry-run, точным сопоставлением памяти и навыков, обработкой секретов, переключением каналов, откатом и ручными исправлениями.”}) — hermes claw migrate сопоставляет персона, память, навыки, провайдеров и MCP-серверы, но cron-задачи, плагины и многоагентная маршрутизация должны быть пересозданы вручную.

Примечания для Windows и Android

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

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

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

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

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

Hermes предлагает три дополняющих друг друга входа:

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

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

hermes model
hermes tools
hermes

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

Подтвердите выполнение инструментов на раннем этапе

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

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

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

Show my disk usage and the five largest directories.

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

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

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}. Это полезно, когда вы хотите хранить определенные значения в окружении, продолжая ссылаться на них в структурированной конфигурации.

Песочницы и backend’и выполнения

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

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

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

Минимальный пример backend 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"

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

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

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

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

Встроенная память хранится в файлах, таких как MEMORY.md и USER.md, в ~/.hermes, и Hermes также может использовать внешних провайдеров памяти для более глубокого вспоминания. Документация по памяти перечисляет несколько плагинов провайдеров, а руководство по провайдерам памяти документирует интерактивный процесс настройки. Для полного технического разбора того, как работает архитектура памяти — замороженные снапшоты, лимиты символов, внешние провайдеры и философия ограниченной памяти — смотрите [Система памяти Hermes Agent: Как действительно работает постоянная AI-память](https://www.glukhov.org/ru/ai-systems/hermes/hermes-agent-memory-system/ “Глубокое техническое руководство по архитектуре памяти Hermes Agent — от ограниченной ядровой памяти на 2 файла до подключаемых внешних провайдеров.”}. Если вы хотите локальный, самоуправляемый провайдер с необычно детализированным контролем над тем, что записывается автоматически, смотрите [Mnemosyne for Hermes Agent: Быстрый старт с локальной памятью](https://www.glukhov.org/ru/ai-systems/hermes/mnemosyne-memory/ “Установите Mnemosyne как локальный провайдер памяти Hermes, настройте вспоминание и удержание, а также проверьте хранилище SQLite.”}) — и [Самоусиливающие циклы памяти в AI-агентах](https://www.glukhov.org/ru/ai-systems/memory/self-reinforcing-memory-loops/ “Память агента может превращать выводы модели в будущие доказательства.”}, чтобы понять, почему консервативные значения по умолчанию для записи так важны в первую очередь.

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

Для более глубокого взгляда на то, какие навыки хорошо работают в продакшене по ролям — инженеры, исследователи, операторы и исполнительские рабочие процессы — смотрите [Навыки AI-ассистента 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-frontmatter, прогрессивным раскрытием, условной активацией, секретами против конфигурации и устранением неполадок с индексом.”}.

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

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

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

Базовая линия, которая склонна не “протухнуть”:

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

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

У Hermes есть терминальный интерфейс (TUI), а не веб-UI, и он спроектирован для долгих сессий с slash-командами, возобновляемыми сессиями и стримингом вывода инструментов.

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

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

Мессенджерский шлюз для доступа 24/7

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

Настройка запускается через hermes gateway setup, и шлюз может работать на переднем плане или как сервис пользователя. Справочник CLI документирует подкоманды шлюза, такие как run, install, start, stop, status и restart. Если вы хотите, чтобы эта модель шлюза работала на выделенном сервере, а подключение происходило с отдельного настольного клиента, используйте [Hermes Agent Headless Server and Remote Desktop Setup](https://www.glukhov.org/ru/ai-systems/hermes/hermes-remote-backend-desktop/ “Запустите Hermes Agent на headless-сервере с доступом через удаленный рабочий стол, systemd-сервисами, разделением шлюза и паттернами безопасного сетевого доступа.”}.

Для многоагентных бэклогов и контролируемого планирования смотрите [Kanban в Hermes Agent для самохостинговых LLM-рабочих процессов](https://www.glukhov.org/ru/ai-systems/hermes/kanban-in-hermes/ “Настройте Kanban в Hermes для безопасного планирования многоагентных задач на самохостинговых LLM с использованием демон-диспетчера, лимитов скорости и пакетирования на основе cron.”}, где описаны лимиты диспетчера, цепочки зависимостей и пакетирование на основе cron.

Безопасность для бота с инструментами важна. Документация по шлюзу описывает списки разрешений (allowlists) для конкретных платформ и процесс pairing 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 not found” и проблемы с правами, вызванные смешением установок через sudo и установок для пользователя.

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

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

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

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

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

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

Если команды терминала немедленно завершаются с ошибкой, руководство по конфигурации содержит раздел “частые проблемы с backend терминала” и указывает на типичные причины для каждого backend, включая остановленный Docker и отсутствующие SSH-переменные. Также отмечается, что откат на local является валидным шагом при отладке, если под вопросом конфигурация песочницы.

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

Ссылки

• Hermes Agent Homepage
• Система памяти Hermes Agent: Как действительно работает постоянная AI-память
• Навыки AI-ассистента Hermes для реальных производственных конфигураций