Что такое агент Гермес?
Hermes Agent — это личный агент с открытым исходным кодом от Nous Research, обладающий постоянной памятью, умением пользоваться инструментами и навыками.
Эта установка агента Hermes использует встроенный поставщик Tencent TokenHub и сохраняет TOKENHUB_API_KEY в документированном файле среды. Прежде чем тестировать безопасную задачу, выберите доступную модель из действующего каталога. Агент Hermes может сочетать в себе постоянную память, навыки, инструменты и различные пользовательские интерфейсы, но эти интерфейсы не заменяют базовую конфигурацию поставщика. Установите из официального проекта Nous Research, защитите файл среды и оцените эффективность инструмента, контекстные потребности, задержку и эксплуатационные расходы на реальной задаче с низким уровнем риска.
Hermes Agent может направлять запросы к моделям через совместимый API-шлюз TokenHub OpenAI compatible. Используйте официальный способ установки, затем замените только API key, Base URL и model ID.
Endpoint TokenHub для этого руководства: https://us-api.tokenhub.com/v1/chat/completions.
Когда использовать
Начните с небольшого репозитория или тестового проекта. Сначала попросите инструмент читать файлы, объяснять код или составлять план, затем включайте правки.
Установите или откройте инструмент
Следуйте официальной документации Hermes Agent для установки или запуска. Если интерфейс изменился, ориентируйтесь на актуальную документацию.
Для CLI-инструментов сначала убедитесь, что исполняемый файл доступен, и только потом добавляйте учетные данные TokenHub:
hermes --versionПодготовьте учетные данные TokenHub
Создайте TokenHub API key и выберите подходящую модель в списке моделей TokenHub.
export TOKENHUB_API_KEY="sk-..."Храните ключ в локальном shell, секретном хранилище IDE или защищенном поле API key инструмента. Не коммитьте ключ в репозиторий.
Настройте провайдера TokenHub
В настройках Models, Providers, API Keys или OpenAI Compatible укажите следующие значения.
Значения provider
| Поле | Значение |
|---|---|
| Провайдер | OpenAI Compatible или Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Значение TOKENHUB_API_KEY |
| Модель | gpt-4.1 или другой model ID TokenHub |
Расположение настроек
| Поле | Значение |
|---|---|
| Secret | ~/.hermes/.env |
| Provider and model config | ~/.hermes/config.yaml |
| Named custom provider | tokenhub-custom |
TOKENHUB_API_KEY=sk-...custom_providers:
- name: tokenhub-custom
base_url: '__API_BASE_URL__/v1'
key_env: TOKENHUB_API_KEY
api_mode: chat_completions
model:
provider: 'custom:tokenhub-custom'
default: 'gpt-4.1'This follows Hermes' current named custom provider schema: base_url is the OpenAI-compatible Base URL, key_env reads the secret without writing it into YAML, and api_mode: chat_completions selects /v1/chat/completions.
Always keep the custom: prefix. Hermes treats bare tokenhub as a built-in provider alias; custom:tokenhub-custom unambiguously selects this self-hosted endpoint.
/model custom:tokenhub-custom:gpt-4.1hermes chatHermes stores the named custom provider, Base URL, API mode, and default model in ~/.hermes/config.yaml. The API key remains in ~/.hermes/.env. You can also run hermes model, select Custom Endpoint, and enter the same values interactively.
Если инструмент разделяет chat, edit, apply и fast models, для первого теста используйте одну и ту же модель TokenHub. После проверки разделите их по стоимости, задержке и силе рассуждения.
Временные переменные только для диагностики
Используйте временные переменные только для проверки ключа, сети и имени модели. После проверки перенесите те же значения в постоянную конфигурацию выше.
export TOKENHUB_API_KEY="sk-..."Проверьте подключение
Сначала используйте read-only prompt, чтобы убедиться, что модель читает контекст и не меняет файлы. Потом проверяйте редактирование и agent tasks.
Прочитай README проекта и кратко опиши его в трех предложениях. Не изменяй файлы.После успешного prompt проверьте в логах TokenHub имя модели, endpoint, расход tokens и billing group.
Устранение неполадок
| Симптом | Что сделать |
|---|---|
| 401 или ошибка аутентификации | Проверьте, что TOKENHUB_API_KEY действителен и сохранен в том же terminal, IDE или профиле клиента. |
| 404 или модель не найдена | Используйте model ID, который есть в рабочей области TokenHub и подходит выбранному протоколу. |
| Неверный endpoint | Оставьте Base URL точно как указано выше. OpenAI-compatible tools обычно требуют /v1; Claude-compatible tools обычно нет. |
| Таймаут запроса | Проверьте сеть до https://us-api.tokenhub.com, proxy settings и allowlist рабочей области. |
| Инструмент использует другую модель | Проверьте все поля chat, edit, apply, fast и autocomplete. |
Как выбрать модель
Часто задаваемые вопросы по настройке агента Hermes
Какого провайдера мне выбрать в Hermes Agent?
Выберите Tencent TokenHub в модели Hermes. Его документированный идентификатор поставщика — tencent-tokenhub, с псевдонимом tokenhub.
Куда должен идти ключ API TokenHub?
Сохраните TOKENHUB_API_KEY=... в ~/.hermes/.env, который является файлом учетных данных документов агента Hermes для этого провайдера.
Почему мне не следует жестко запрограммировать модель из этого руководства?
Каталог Tencent TokenHub доступен, и доступные модели могут меняться. Выберите модель, представленную моделью Hermes, или введите точный доступный на данный момент идентификатор.
Как связаны Hermes Agent и Nous Research?
Hermes Agent — это агентский проект с открытым исходным кодом от Nous Research. Поиск финансирования или оценки компании выходит за рамки данного руководства по интеграции.
Как мне сравнить Hermes Agent с OpenClaw?
Используйте одну и ту же реальную задачу для сравнения развертывания, памяти, навыков, интеграции каналов, надежности инструментов, стоимости модели и сложности обслуживания.
Источники
Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-04。