Podłączanie Hermes, OpenClaw i innych agentów AI

Hermes Agent, OpenClaw i większość agentów innych firm może korzystać z NordRouter jako dostawcy OpenAI-compatible. Nie jest potrzebna osobna subskrypcja twórcy agenta; żądania są rozliczane z salda NordRouter według rzeczywistego użycia.

Dane połączenia

Pole	Wartość
Base URL w Rosji	https://nordrouter.com/v1
Poza Rosją lub przez VPN	https://global-api.nordrouter.com/v1
Serwer europejski	https://europe-api.nordrouter.com/v1
API Key	pełny klucz sk-nr-… z panelu
Model ID	na przykład anthropic/claude-sonnet-4.6

Zachowaj /v1 na końcu Base URL i skopiuj pełny identyfikator z katalogu.

Hermes Agent

Hermes Agent obsługuje własne endpointy OpenAI-compatible.

Konfiguracja kreatorem

Zamknij aktywną sesję Hermes i uruchom:

hermes model

Wybierz Custom endpoint (self-hosted / VLLM / etc.) i podaj:

• API base URL: https://nordrouter.com/v1
• API key: klucz sk-nr-… bez dodatkowego prefiksu
• Model name: anthropic/claude-sonnet-4.6
• Context window: 1000000

Po zapisaniu uruchom nową sesję. /model w czacie przełącza tylko wcześniej skonfigurowanych dostawców; nowy endpoint dodaje się poleceniem hermes model w terminalu.

Konfiguracja ręczna

Zaktualizuj blok model w ~/.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

Nie używaj starej zmiennej LLM_MODEL: aktualny Hermes korzysta z config.yaml jako źródła konfiguracji. Modele auxiliary ustawione na auto używają modelu głównego; jawne ustawienia vision, compression lub subagents również wymagają zgodnego endpointu.

OpenClaw

OpenClaw dodaje własnych dostawców przez models.providers.

1. Zapisz klucz osobno

Utwórz ~/.openclaw/.env (Windows: %USERPROFILE%\.openclaw\.env):

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Nie zapisuj klucza w projektowym .env i nie wysyłaj go do Git.

2. Dodaj dostawcę

Połącz ten obiekt z istniejącym ~/.openclaw/openclaw.json. Nie zastępuj obecnych kanałów, narzędzi ani agentów:

{
  "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
          }
        ]
      }
    }
  }
}

Dla kolejnego modelu dodaj do models obiekt z jego pełnym publicznym ID.

3. Sprawdź

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

Jeśli CLI wymaga restartu, uruchom openclaw gateway restart --safe. Do diagnostyki służy openclaw logs --follow.

Inni agenci AI

Jeśli aplikacja oferuje Custom provider, OpenAI Compatible, Custom OpenAI lub Chat Completions, wpisz Base URL, klucz i Model ID z tabeli. Aplikacja powinna sama dodać /chat/completions.

Jeżeli obsługuje wyłącznie logowanie do oficjalnego konta OpenAI lub Anthropic i nie pozwala zmienić Base URL, nie może połączyć się bezpośrednio z NordRouter.

Funkcje i bezpieczeństwo

Obsługiwane są zwykłe i strumieniowe odpowiedzi, tool/function calling, komunikaty systemowe, długi kontekst, reasoning w zgodnych modelach oraz Vision w modelach oznaczonych w katalogu. Funkcję musi obsługiwać model i klient.

Hermes i OpenClaw mogą uruchamiać polecenia i modyfikować pliki. Pierwszy test wykonaj w katalogu bez sekretów, włącz sandbox lub zatwierdzanie niebezpiecznych działań i nie udostępniaj serwera produkcyjnego.

Częste błędy

Błąd	Rozwiązanie
401 Invalid API key	Użyj pełnego klucza bez powtórzonego sk-nr- i bez spacji
/v1/v1/chat/completions	Pozostaw dokładnie jedno /v1
No pricing available for model	Użyj pełnego ID wraz z częścią przed /
Nadal działa stary model	Otwórz nową sesję; w OpenClaw uruchom /model default
503 Service Unavailable	Wypróbuj inny model i sprawdź status

Najpierw zweryfikuj klucz minimalnym żądaniem z szybkiego startu. Oficjalne źródła: Hermes providers i OpenClaw providers.