Конфигурация Hermes Agent

Узнайте, как настроить Hermes Agent, включая файлы конфигурации, настройки поставщика LLM, конфигурацию инструментов и все доступные параметры конфигурации.

Выберите поставщика модели

Hermes поддерживает 300+ моделей и более десятка поставщиков.

Nous Portal — это собственный шлюз подписки Nous Research. Один вход OAuth покрывает вызов моделей + шлюз инструментов (веб-поиск, генерация изображений, TTS, автоматизация браузера):

hermes setup --portal

Приведённая выше команда откроет браузер для завершения авторизации OAuth, установит Nous в качестве провайдера инференса и одновременно включит все шлюзы инструментов.

Мастер полной настройки (со встроенным API Key):

hermes setup

Мастер предоставляет три режима:

Mode Описание Кому это подходит
Быстрая настройка (Nous Portal) Вход через OAuth в один клик, API Key не требуется Новые пользователи, которые хотят как можно быстрее начать работу
Полная настройка Пошаговая настройка каждого провайдера и инструмента Пользователи, которые хотят настроить всё под себя
Чистый лист Включить только минимальное ядро (файловые операции + терминал), отключить всё остальное Продвинутые пользователи, которым нужен точный контроль

Выбрать провайдера вручную

Используйте следующую команду для просмотра доступных провайдеров:

hermes model

Используйте клавиши со стрелками вверх/вниз для выбора, Enter для подтверждения конфигурации:

Распространённые методы настройки провайдера:

провайдер Способ настройки
Nous Portal hermes setup --portal(OAuth)
Anthropic(Claude) Вход через OAuth (требуется план Max + дополнительная квота использования), или настроитьANTHROPIC_API_KEY
OpenRouter НастройкиOPENROUTER_API_KEY
OpenAI НастройкиOPENAI_API_KEY
Google AI Studio НастройкиGOOGLE_API_KEY
xAI(Grok OAuth) hermes model → xAI Grok OAuth
Локальная модель (LM Studio) НастройкиLM_API_KEYиLM_BASE_URL

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


Используйте CC Switch для настройки в один клик

Далее мы используем CC Switch, чтобы Hermes мог использовать большие модели, такие как Qwen, GLM, Kimi, DeepSeek. CC Switch — это открытый кроссплатформенный настольный инструмент, который централизованно управляет AI-ассистентами для программирования, такими как Claude Code, Codex и Gemini CLI, поддерживая переключение API-провайдеров, моделей и конфигураций в один клик.

Вы можете скачать его с официального сайта:https://ccswitch.io/zh/。

Также можно перейти на GitHub Releases: https://github.com/farion1231/cc-switch/releases/latestСкачать установочный пакет для вашей платформы.

Прокрутите в самый низ веб-страницы, в разделе с пакетом ресурсов скачайте установочный пакет для вашей платформы:

После скачивания и установки CC Switch мы выбираем Hermes, затем нажимаем кнопку «Create» в правом верхнем углу.

В конфигурации выберите Custom:

Мы можем использовать Coding Plan, который всё ещё самый экономически выгодный, ведь это месячная подписка:

Здесь мы выбрали Ark от ByteDance, ввели API Key и адрес запроса, адрес запроса, совместимый с OpenAI:https://ark.cn-beijing.volces.com/api/coding/v3, задали ваш API-ключ и выбрали нужную модель. Что здесь выбрано —deepseek-v4-pro:

После настройки нажмите кнопку сохранения в правом нижнем углу. Вернувшись в главный интерфейс, мы увидим настроенную информацию. Можно проверить, успешна ли настройка, затем включить её:

После включения мы переходим в интерфейс командной строки, чтобы использовать её.hermesКоманда для запуска Hermes:

hermes

Как видите, модель успешно настроена и готова к использованию.

Более подробную информацию о CC Switch см. здесь:https://www.example.com/ai-agent/cc-switch.html


Расположение файла конфигурации

Hermes Agent использует следующие файлы конфигурации:

Файл Описание
~/.hermes/config.yaml Основной файл конфигурации
~/.hermes/.env Переменные окружения (ключи API и т. д.)
~/.hermes/state.db База данных сессий SQLite
~/.hermes/skills/ Каталог установленных навыков
~/.hermes/sessions/ Каталог хранения сессий
~/.hermes/memories/ Постоянное хранилище памяти
Другие расширения