Hermes Agent Руководство по настройке
Модель Hermes Agent, поставщики и настраиваемые endpoint сохраняются в ~/.hermes/config.yaml; чувствительная информация, такая как API Key, хранится в ~/.hermes/.env. ai2save использует интерфейс OpenAI Compatible, а Base URL — это https://ai2save.com/v1.
1. Создание API Key
- Откройте https://ai2save.com/keys.
- Создайте ключ и выберите группу, содержащую целевую модель.
- Скопируйте полный
sk-...ключ. - Запишите в консоли отображаемый реальный ID модели, например
gpt-5.5.
2. Рекомендовано использовать встроенный мастер
Выполните в терминале:
hermes model
Выберите согласно подсказке:
Custom endpoint (self-hosted / vLLM / etc.)
Введите по очереди:
API base URL: https://ai2save.com/v1
API key: sk-ваш-api-ключ
Model name: gpt-5.5
Гид запишет эти значения в ~/.hermes/config.yaml. Не записывайте Base URL в .env; официальное соглашение Hermes о конфигурации endpoint модели исходит из config.yaml.
3. Ручное редактирование конфигурационного файла
Редактируйте ~/.hermes/config.yaml:
model:
provider: custom
default: gpt-5.5
base_url: https://ai2save.com/v1
key_env: AI2SAVE_API_KEY
Описание полей:
provider: custom: Используйте любой OpenAI Compatible endpoint.default: ID модели по умолчанию, должен полностью совпадать с ID модели, открытой в консоли.base_url: Должен идти вместе с/v1, Hermes на основе этого сделает запрос/chat/completions.key_env: Указывает имя переменной окружения, в которой хранится ключ.
Редактировать ~/.hermes/.env:
AI2SAVE_API_KEY=sk-ваш-api-ключ
.env сохраняет конфиденциальную информацию, config.yaml сохраняет неконфиденциальные настройки модели. Не отправляйте .env в Git.
4. Запись с помощью команды конфигурации
Также можно использовать встроенные команды Hermes, чтобы избежать ошибок YAML с отступами:
hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-ваш-api-ключ
hermes config check
AI2SAVE_API_KEY — это имя переменной окружения в верхнем регистре, Hermes автоматически запишет ~/.hermes/.env.
5. Перезапуск и проверка
- Полностью выйдите из текущей сессии Hermes или Gateway.
- Перезапустите Hermes.
- Создайте новую сессию и отправьте короткий вопрос.
- Введите в сессии
/model, чтобы подтвердить, что текущая модель —custom/gpt-5.5илиgpt-5.5.
Временное использование указанной модели:
hermes chat --provider custom --model gpt-5.5
Рекомендуется при первой проверке отключить параллельные задачи и сложные инструменты, отправлять только короткие тексты. После аутентификации и подключения модели постепенно включать инструменты terminal, web, file и др.
6. Частые ошибки
- 401 / invalid_api_key:
AI2SAVE_API_KEYне существует или значение неполное. Выполните проверку ссылкиhermes config get model.key_env. - 404 / model not found:
model.defaultне является настоящим ID модели, доступной в консоли. - Сбой соединения:
base_urlдолжен бытьhttps://ai2save.com/v1; не пишите какhttps://ai2save.com. - Конфигурация не применена: устаревший
OPENAI_BASE_URLвлияет только наopenai-apiProvider, не применяется автоматически кcustom; проверьтеconfig.yamlдляmodel.base_url. - Ошибка разбора YAML: не должно быть повторяющихся блоков
model:, объедините все поля в одном блоке. - Аномалия вызова инструмента: сначала убедитесь, что модель поддерживает tool calling, и установите базовые запросы короткими текстами, затем включайте набор инструментов.