Конфигурация 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/ |
Постоянное хранилище памяти |