Hermes, OpenClaw и другие AI-агенты

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

Что понадобится

• API-ключ sk-nr-… из личного кабинета;
• Base URL с /v1;
• полный Model ID из каталога моделей.

Какой Base URL выбрать

Где запускается агент	Base URL
Россия	https://nordrouter.com/v1
За пределами России или через VPN	https://global-api.nordrouter.com/v1
Европейский сервер	https://europe-api.nordrouter.com/v1

В примерах ниже используется российский адрес. При необходимости замените только домен, сохранив /v1.

Hermes Agent

Hermes Agent поддерживает пользовательские OpenAI-compatible endpoints. В актуальных версиях модель и endpoint сохраняются в ~/.hermes/config.yaml.

Подключение через мастер

Закройте активную сессию 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

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

Ручная настройка

Откройте ~/.hermes/config.yaml и добавьте или обновите блок model:

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-модели для vision, compression или subagents, им тоже нужно указать совместимый endpoint и доступную в NordRouter модель. При значении auto они используют основную модель.

OpenClaw

OpenClaw добавляет пользовательские провайдеры через models.providers. Внутри OpenClaw модель будет называться nordrouter/anthropic/claude-sonnet-4.6, но в NordRouter отправится правильный публичный ID anthropic/claude-sonnet-4.6.

1. Сохраните ключ отдельно

Создайте или откройте глобальный файл:

• macOS / Linux: ~/.openclaw/.env;
• Windows: %USERPROFILE%\.openclaw\.env.

Добавьте строку:

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Глобальный .env OpenClaw подходит для ключей провайдеров. Не кладите ключ в .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. Если модель принимает изображения, укажите для неё "input": ["text", "image"] только когда поддержка Vision отмечена в каталоге.

3. Проверьте и включите модель

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

OpenClaw обычно применяет корректный конфиг автоматически. Если CLI сообщает, что нужен перезапуск, выполните безопасный вариант:

openclaw gateway restart --safe

После этого отправьте короткое сообщение в новом чате. Для диагностики используйте openclaw logs --follow.

Любой другой AI-агент

Если программа предлагает Custom provider, OpenAI Compatible, Custom OpenAI или Chat Completions, заполните:

Поле	Значение
Provider	NordRouter или Custom OpenAI
Base URL	https://nordrouter.com/v1
API Key	ваш полный ключ sk-nr-…
Model	например, anthropic/claude-sonnet-4.6
API format	OpenAI Chat Completions

Программа сама должна добавить путь /chat/completions. Не вписывайте его в Base URL, иначе может получиться неправильный адрес.

Когда подключение невозможно

Если приложение разрешает только вход через официальный аккаунт OpenAI/Anthropic и не даёт изменить Base URL, напрямую подключить NordRouter нельзя. Не вставляйте ключ в поле, предназначенное исключительно для официального провайдера.

Какие возможности работают

• обычные и потоковые ответы;
• tool/function calling для агентных действий;
• системные сообщения и длинный контекст;
• reasoning-параметры у поддерживающих их моделей;
• Vision у моделей с соответствующей отметкой в каталоге;
• единый баланс и детализация запросов в личном кабинете.

Конкретная возможность зависит одновременно от выбранной модели и клиента. Например, наличие Vision у модели не поможет, если сам агент не отправляет изображения в OpenAI-compatible формате.

Безопасный первый запуск

Hermes и OpenClaw могут выполнять команды, изменять файлы и обращаться к внешним сервисам. Для первой проверки:

1. создайте тестовую папку без секретов;
2. включите подтверждение опасных действий или sandbox;
3. не выдавайте агенту доступ к production-серверу;
4. начните с короткой задачи и проверьте расход в разделе «Активность»;
5. подключайте мессенджеры, браузер и дополнительные skills только после проверки базовой модели.

Частые ошибки

Ошибка	Что проверить
401 Invalid API key	Вставлен полный ключ sk-nr-…, без sk-nr-sk-nr- и без пробелов
404 или /v1/v1/chat/completions	Base URL должен заканчиваться ровно одним /v1
No pricing available for model	Используйте полный ID из каталога, включая часть до /
Модель отвечает, но tools не работают	Выберите современную модель с tool calling и проверьте режим API клиента
После смены конфига используется старая модель	Откройте новую сессию; в OpenClaw сбросьте закреплённую модель через /model default
503 Service Unavailable	Обычно временно недоступна конкретная модель; попробуйте другую и проверьте статус

Сначала проверьте ключ минимальным запросом из быстрого старта. Если прямой запрос работает, а агент — нет, проблема находится в его конфигурации.

Официальные инструкции

• Hermes Agent: custom providers
• OpenClaw: model providers
• OpenClaw: configuration