Как установить Hermes Agent: руководство по настройке для начинающих

Hermes Agent — это агент с открытым исходным кодом от Nous Research, который работает из терминала, подключается к разным провайдерам моделей, запоминает полезный контекст между сессиями и может быть расширен инструментами, skills, шлюзами для мессенджеров и автоматизацией. Это руководство поможет вам разобраться, как установить Hermes. Вам не нужно вручную устанавливать Python или Node.js для стандартного установщика на macOS или Windows, так как официальный установщик берёт на себя установку основных зависимостей.

Перед установкой Hermes Agent

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

• macOS: откройте Terminal через Applications > Utilities > Terminal, либо нажмите Command + Space и найдите «Terminal».

• Windows: сначала установите WSL2, откройте терминал вашего дистрибутива Linux, затем следуйте команде для Linux.

Также вам понадобится Git. Проверьте, установлен ли он:

Ожидаемый результат:

Если вы видите git: command not found, сначала установите Git:

Если у вас на macOS не установлен Homebrew, установите Git через Apple Command Line Tools, выполнив:

Шаг 1: установка Hermes Agent на macOS или Windows

В терминале скопируйте и вставьте команду официального установщика:

Установщик загружает Hermes Agent, подготавливает окружение Python, устанавливает необходимые зависимости и добавляет команду hermes в путь вашей оболочки. При обычной пользовательской установке данные Hermes хранятся в ~/.hermes/.

После завершения выполнения команды перезагрузите оболочку:

Если вы используете Zsh, что часто встречается на macOS, выполните:

Ожидаемый результат:

Теперь убедитесь, что команда Hermes Agent доступна:

Ожидаемый результат:

Точный номер версии может измениться по мере обновления Hermes Agent.

Шаг 2: настройка провайдера модели

Перед тем как Hermes Agent сможет отвечать или использовать инструменты, ему нужен провайдер модели. Самый простой способ для новичков — интерактивная настройка:

Мастер настройки позволяет выбрать провайдера, например Kimi/Moonshot. Не настраивайте маршрутизацию, резервный переход, шлюз или cron, пока не заработает базовый чат.

Выберите модель по умолчанию. kimi-k2.6 — самая продвинутая модель Kimi на данный момент.

Если вы уже знаете, какое значение хотите задать, можно использовать hermes config set. Например:

Если у вас нет api-key, Kimi может быть неплохим выбором.

Шаг 1: активируйте свой Kimi API

Перед использованием Kimi API с Hermes Agent активируйте ваш Kimi API Key на Kimi Platform. Мы рекомендуем пополнить баланс на $20 и более, чтобы открыть доступ к Tier 2, что снижает задержки и обеспечивает более стабильную работу при выполнении сложных многошаговых задач

Шаг 2: создайте свой Kimi API Key

Перейдите в раздел API Keys на Kimi Platform и нажмите Create API Key. Не забудьте скопировать свой API-ключ и сохранить его в надёжном месте, поскольку он показывается только один раз при создании.

Шаг 3: введите свой API-ключ

Вставьте свой Kimi API-ключ и подключите Hermes Agent.

Шаг 3: запустите Hermes Agent

Когда модель настроена, запустите классический CLI:

Или попробуйте новый терминальный интерфейс:

Вы должны увидеть экран приветствия или строку ввода с выбранным вами провайдером/моделью. Проверьте её простым запросом:

Успешный результат выглядит так:

Если Hermes Agent открывается, но отвечает ошибками модели или авторизации, выполните:

Затем выберите провайдера снова и проверьте API-ключ или вход через OAuth.

Шаг 4. Превращаем Hermes Agent в бота

Как и OpenClaw, Hermes Agent может работать как бот и подключаться к вашим чат-приложениям:

После настройки проверьте статус шлюза:

Используйте шлюз только после того, как провайдер модели заработал в терминале. Если CLI не может выполнить базовый чат, бот обычно не заработает по той же причине.

Частые проблемы при установке Hermes Agent

hermes: command not found

Причина: терминал ещё не подхватил изменение PATH.

Решение:

Или:

Затем попробуйте:

git: command not found

Причина: Git не установлен.

Решение для Ubuntu, Debian или WSL2:

Решение для macOS через Homebrew:

API-ключ не задан

Причина: Hermes Agent установлен, но ключ провайдера или вход не настроены.

Решение:

Или задайте ключ вручную:

hermes doctor сообщает об отсутствующей или устаревшей конфигурации

Причина: после обновления файл конфигурации может быть неполным.

Решение:

Пользовательский эндпоинт подключается, но выдаёт неверные ответы

Причина: неверный базовый URL, название модели или длина контекста.

Решение: сначала протестируйте эндпоинт в отдельном клиенте, убедитесь, что он совместим с OpenAI, и проверьте, что модель поддерживает контекст не менее 64K для нормальной работы Hermes Agent.

Краткий справочник команд

Заключение

Самый простой способ установить Hermes Agent — использовать официальный однострочный установщик, перезапустить оболочку, выполнить hermes model и проверить настройку одним реальным чатом плюс hermes doctor. Держите первую настройку простой: одна машина, один провайдер, один рабочий диалог. Когда базовый ассистент Hermes Agent стабильно работает, можно безопасно расширять его изоляцией через Docker, ботами-шлюзами, навыками, запланированными автоматизациями и пользовательскими провайдерами моделей.