https://bettertoken.ai/v1 и точный Model ID.
Hermes Agent: установка и API timeout
Если Hermes Agent завершает запрос по timeout, сначала проверьте короткий запрос без инструментов и уменьшите объём контекста. Сравните конфигурацию с OpenClaw и Codex CLI, а адрес проверьте по руководству по Base URL.Ключевые параметры
Подготовка
- Установленная актуальная версия инструмента
- API Key BetterToken: зарегистрироваться и получить
- Model ID из каталога моделей
Дополнительные требования
- выбранный Model ID доступен у провайдера GPT
- macOS, Linux или Windows WSL2
Установка
Установка Hermes Agent
- macOS / Linux / WSL2
- Windows
Ручная настройка
Основной способ — интерактивный интерфейс настройки моделей Hermes Agent. Команды и переменные окружения остаются дополнительными вариантами.Настройка
- Интерактивная настройка
- CLI config
- Environment variables
1
Запустите выбор модели
2
Выберите OpenAI или OpenAI Compatible provider
Выберите OpenAI или OpenAI Compatible в списке providers.
3
Заполните конфигурацию BetterToken
Введите:
- Base URL:
https://bettertoken.ai/v1 - API Key: ваш API Key BetterToken
- Model: Model ID провайдера GPT из model plaza
4
Перезапустите Hermes Agent
После обновления конфигурации завершите текущую сессию Hermes Agent и запустите ее снова.
5
Запустите Hermes Agent
Кратко о возможностях
Troubleshooting
- Если запросы не отвечают или завершаются ошибкой, проверьте, что Base URL равен
https://bettertoken.ai/v1. Обычно здесь не нужно добавлять/chat/completions. - Если Hermes сообщает, что модель не существует, проверьте, что Model — это Model ID поддерживаемого провайдера из model plaza.
- Если возникает ошибка авторизации, проверьте лишние пробелы в API Key и убедитесь, что Model ID доступен у провайдера GPT.
- Если после изменения настроек Hermes все еще использует старую модель, завершите текущую сессию Hermes Agent и снова выполните
hermes. - BetterToken обычно не требует дополнительного
User-Agentили custom headers. Добавляйте headers только если этого явно требует ваш custom gateway, tenant routing, observability или caching layer.
Не коммитьте реальные API Keys в репозиторий. Для командных конфигураций используйте environment variables или локальную конфигурацию.
Проверка подключения
Отправьте короткий тестовый запрос. Если инструмент возвращает ответ без ошибок авторизации или Model ID, подключение работает. После изменения конфигурации полностью перезапустите инструмент.Смена модели
Откройте селектор моделей или измените полеModel в конфигурации. Используйте точный Model ID из каталога моделей, затем перезапустите текущую сессию.
Частые ошибки
- MCP и API Key / Base URL
- Что такое model_provider, base_url и wire_api?
- Как настроить OpenAI-compatible API в Cline
- Настройка OpenClaw с BetterToken
Расширенная настройка
Поддерживаемые провайдеры
Статусы относятся к способу подключения BetterToken, описанному на этой странице.
Что означают способы настройки
Что означают способы настройки
- Ручная настройка: укажите API Key, Base URL и Model.
- Не поддерживается: проверенный способ прямого подключения пока отсутствует.
Технические детали
Протокол, endpoint и внутренние параметры provider
Протокол, endpoint и внутренние параметры provider
В описанном сценарии используется Base URL После проверки результата выполните миграцию:После миграции все равно проверьте Base URL, API Key и model ID в Hermes Agent. Они должны соответствовать
https://bettertoken.ai/v1. Инструмент сам добавляет путь OpenAI-compatible endpoint. Не добавляйте /chat/completions или /responses к Base URL, если это не требуется конкретным полем.Миграция с OpenClaw
Если вы уже используете OpenClaw, сначала проверьте, есть ли в вашей текущей версии Hermes Agent команда миграции. Перед изменениями запустите dry run.https://bettertoken.ai/v1, вашему API Key BetterToken и Model ID поддерживаемого провайдера.