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

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

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

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

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

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

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

Если вы переходите из существующего развертывания OpenClaw, а не начинаете с чистого листа, сначала установите и проверьте пустой Hermes, а затем следуйте поэтапному переключению в Как безопасно мигрировать с OpenClaw на Hermes Agent — команда 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. Это важно, потому что включает в себя как хостинговые сервисы, так и self-hosted эндпоинты.

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

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

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

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

Show my disk usage and the five largest directories.

Если 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, такое как сброс возможностей и отключение повышения привилегий.

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

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

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

Встроенная память хранится в файлах, таких как MEMORY.md и USER.md, в каталоге ~/.hermes, и Hermes также может использовать внешних поставщиков памяти для более глубокого вспоминания. Документация по памяти перечисляет несколько плагинов-поставщиков, а руководство по поставщикам памяти документирует интерактивный поток настройки. Для полного технического разбора того, как работает архитектура памяти — замороженные снимки, лимиты символов, внешние поставщики и философия ограниченной памяти — см. Система памяти Hermes Agent: Как на самом деле работает постоянная память ИИ. Если вы хотите локальный, self-hosted поставщик с необычно детализированным контролем над тем, что записывается автоматически, см. Mnemosyne для Hermes Agent: Быстрый старт локальной памяти — и Самоусиливающие циклы памяти в ИИ-агентах о том, почему консервативные значения записывания по умолчанию вообще важны.

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

Для более глубокого взгляда на то, какие навыки хорошо работают в производстве по ролям — инженеры, исследователи, операторы и исполнительские рабочие процессы — см. Навыки ИИ-ассистента Hermes для реальных производственных конфигураций. Когда вы будете готовы создавать или отлаживать сами файлы SKILL.md — метаданные YAML, уровни прогрессивного раскрытия, условная видимость и установки хабов — используйте Создание навыков Hermes Agent — Структура SKILL.md и лучшие практики.

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

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

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

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

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

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

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

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

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

Мессенджер-гейтвей для доступа 24/7

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

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

Для многорабочих бэклогов и контролируемого планирования см. Kanban в Hermes Agent для self-hosted рабочих процессов 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

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

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

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

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

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

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

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

Проблемы с бэкендом терминала и гейтвеем

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

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

Ссылки

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