Hermes, OpenClaw та інші AI-агенти

Hermes Agent, OpenClaw і більшість сторонніх AI-агентів можна підключити до NordRouter як OpenAI-compatible провайдер. Окрема підписка розробника агента не потрібна: запити оплачуються з балансу NordRouter за фактичним використанням.

Дані підключення

Поле	Значення
Base URL у Росії	https://nordrouter.com/v1
За межами Росії або через VPN	https://global-api.nordrouter.com/v1
Європейський сервер	https://europe-api.nordrouter.com/v1
API Key	повний ключ sk-nr-… з кабінету
Model ID	наприклад anthropic/claude-sonnet-4.6

Зберігайте /v1 наприкінці Base URL. Назву моделі копіюйте повністю з каталогу.

Hermes Agent

Hermes Agent підтримує власні OpenAI-compatible endpoints.

Через майстер

Закрийте активну сесію Hermes і виконайте:

hermes model

Оберіть Custom endpoint (self-hosted / VLLM / etc.) та введіть:

• API base URL: https://nordrouter.com/v1;
• API key: ваш ключ sk-nr-… без додаткового префікса;
• Model name: anthropic/claude-sonnet-4.6;
• Context window: 1000000.

Після збереження відкрийте нову сесію. Команда /model у чаті лише перемикає вже налаштовані провайдери; новий endpoint додається через hermes model у звичайному терміналі.

Вручну

Оновіть блок model у ~/.hermes/config.yaml:

model:
  default: anthropic/claude-sonnet-4.6
  provider: custom
  base_url: https://nordrouter.com/v1
  api_key: sk-nr-YOUR-KEY
  context_length: 1000000

Не використовуйте застарілу змінну LLM_MODEL: у сучасному Hermes джерелом істини є config.yaml. Auxiliary-моделі зі значенням auto використовують основну модель; явні перевизначення для vision, compression або subagents потрібно налаштувати окремо.

OpenClaw

OpenClaw додає власних провайдерів через models.providers.

1. Збережіть ключ

Створіть глобальний файл ~/.openclaw/.env (Windows: %USERPROFILE%\.openclaw\.env):

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Не зберігайте ключ у .env окремого проєкту та не публікуйте його в Git.

2. Додайте провайдера

Об’єднайте цей блок з наявним ~/.openclaw/openclaw.json. Не перезаписуйте налаштування каналів, інструментів або агентів:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "nordrouter/anthropic/claude-sonnet-4.6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "nordrouter": {
        "baseUrl": "https://nordrouter.com/v1",
        "apiKey": "${NORDROUTER_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.6",
            "name": "Claude Sonnet 4.6 via NordRouter",
            "contextWindow": 1000000
          }
        ]
      }
    }
  }
}

Для іншої моделі додайте об’єкт до масиву models з її повним публічним ID.

3. Перевірте

openclaw config validate
openclaw models list --provider nordrouter
openclaw models set nordrouter/anthropic/claude-sonnet-4.6

Якщо CLI просить перезапуск, виконайте openclaw gateway restart --safe. Для діагностики використовуйте openclaw logs --follow.

Інші AI-агенти

Якщо програма має режим Custom provider, OpenAI Compatible, Custom OpenAI або Chat Completions, вкажіть Base URL, ключ і повний Model ID з таблиці вище. Програма має сама додати /chat/completions; не вписуйте цей шлях у Base URL.

Якщо клієнт дозволяє лише вхід через офіційний акаунт OpenAI або Anthropic і не дає змінити Base URL, напряму підключити NordRouter неможливо.

Можливості та безпека

Працюють streaming, tool/function calling, системні повідомлення, довгий контекст, reasoning для сумісних моделей і Vision для моделей з відповідною позначкою. Функція має підтримуватися і моделлю, і самим клієнтом.

Hermes та OpenClaw можуть виконувати команди й змінювати файли. Перший тест запускайте у папці без секретів, увімкніть sandbox або підтвердження небезпечних дій і не надавайте доступ до production-сервера.

Типові помилки

Помилка	Рішення
401 Invalid API key	Вставте повний ключ без повторного sk-nr- і пробілів
/v1/v1/chat/completions	Залиште рівно один /v1
No pricing available for model	Використайте повний ID моделі разом із частиною до /
Залишилася стара модель	Відкрийте нову сесію; в OpenClaw виконайте /model default
503 Service Unavailable	Спробуйте іншу модель і перевірте статус

Перевірте ключ мінімальним запитом зі швидкого старту. Офіційні довідки: Hermes providers та OpenClaw providers.