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

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

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

Если вам нужен более широкий обзор самохостящихся ассистентов, поиска и локальной инфраструктуры вокруг Hermes, этот обзор систем ИИ связывает эти темы с теми же проблемами, которые пытается решить Hermes. Для понимания пятиуровневой модели ассистента — LLM, память, инструменты, маршрутизация и наблюдаемость — с Hermes и OpenClaw в качестве эталонных реализаций, см. Архитектура ИИ-ассистентов. Для конкретных данных об использовании — звезды GitHub, ежедневный объем токенов OpenRouter, количество загрузок PyPI, история CVE и настроения сообщества Reddit — OpenClaw vs Hermes Agent: Звезды, загрузки и использование 2026 отслеживает, как Hermes сравнивается с 19 альтернативами по всем измеряемым показателям.

Для компромиссов при развертывании и выбора среды выполнения Хостинг LLM в 2026 году: Локальный, самохостящийся и облачная инфраструктура в сравнении предоставляет карту хостинга, а Производительность LLM в 2026 году: Бенчмарки, узкие места и оптимизация охватывает аспекты пропускной способности и задержки после запуска Hermes. Если вы регулярно используете Qwen или Gemma в локальных средах выполнения, таких как Ollama, консолидируйте параметры температуры и штрафы для многошагового использования инструментов с помощью Параметры агентского инференса LLM для Qwen и Gemma. Для компактной карты команд оболочки (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, после чего переводит вас в состояние, готовое к первому чату.

Примечания по 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, такая как отключение возможностей (capabilities) и запрет эскалации привилегий.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Безопасность для бота, использующего инструменты, важна. В документации шлюза описаны списки разрешенных платформ и поток паринга в личных сообщениях, который выдает одноразовые коды паринга и требует одобрения через 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
• Система памяти Hermes Agent: как на самом деле работает постоянная память ИИ
• Навыки ИИ-ассистента Hermes для реальных продакшен-настроек