Hermes, OpenClaw und andere KI-Agenten verbinden

Hermes Agent, OpenClaw und die meisten Agenten von Drittanbietern können NordRouter als OpenAI-kompatiblen Anbieter verwenden. Ein separates Abo beim Entwickler des Agenten ist nicht nötig; Anfragen werden nach tatsächlicher Nutzung vom NordRouter-Guthaben abgerechnet.

Verbindungsdaten

Feld	Wert
Base URL in Russland	https://nordrouter.com/v1
Außerhalb Russlands oder mit VPN	https://global-api.nordrouter.com/v1
Europäischer Server	https://europe-api.nordrouter.com/v1
API Key	vollständiger sk-nr-…-Schlüssel aus dem Dashboard
Model ID	zum Beispiel anthropic/claude-sonnet-4.6

Am Ende der Base URL muss /v1 stehen. Kopieren Sie die Modell-ID vollständig aus dem Katalog.

Hermes Agent

Hermes Agent unterstützt eigene OpenAI-kompatible Endpoints.

Einrichtung mit dem Assistenten

Beenden Sie die aktive Hermes-Sitzung und führen Sie aus:

hermes model

Wählen Sie Custom endpoint (self-hosted / VLLM / etc.) und tragen Sie ein:

• API base URL: https://nordrouter.com/v1
• API key: Ihr sk-nr-…-Schlüssel ohne zusätzlichen Präfix
• Model name: anthropic/claude-sonnet-4.6
• Context window: 1000000

Starten Sie nach dem Speichern eine neue Sitzung. /model im Chat wechselt nur zwischen bereits eingerichteten Anbietern; einen neuen Endpoint fügen Sie im Terminal mit hermes model hinzu.

Manuelle Konfiguration

Aktualisieren Sie den Block model in ~/.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

Verwenden Sie nicht die veraltete Variable LLM_MODEL: Aktuelle Hermes-Versionen nutzen config.yaml als Quelle. Auxiliary-Modelle mit auto folgen dem Hauptmodell; explizite Einstellungen für vision, compression oder subagents benötigen ebenfalls einen kompatiblen Endpoint.

OpenClaw

OpenClaw definiert eigene Anbieter unter models.providers.

1. Schlüssel getrennt speichern

Erstellen Sie ~/.openclaw/.env (Windows: %USERPROFILE%\.openclaw\.env):

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Speichern Sie den Schlüssel nicht in einer projektbezogenen .env und übertragen Sie ihn nicht in Git.

2. Anbieter hinzufügen

Führen Sie dieses Objekt mit Ihrer vorhandenen ~/.openclaw/openclaw.json zusammen. Bestehende Kanäle, Tools und Agenten dürfen nicht überschrieben werden:

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

Für ein weiteres Modell hängen Sie ein Objekt mit dessen vollständiger öffentlicher ID an models an.

3. Prüfen

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

Falls die CLI einen Neustart verlangt, führen Sie openclaw gateway restart --safe aus. Zur Diagnose dient openclaw logs --follow.

Andere KI-Agenten

Bietet eine Anwendung Custom provider, OpenAI Compatible, Custom OpenAI oder Chat Completions, tragen Sie Base URL, Schlüssel und vollständige Model ID aus der Tabelle ein. Die Anwendung muss /chat/completions selbst ergänzen.

Ist nur die Anmeldung bei einem offiziellen OpenAI- oder Anthropic-Konto möglich und kann die Base URL nicht geändert werden, ist keine direkte NordRouter-Verbindung möglich.

Funktionen und Sicherheit

Unterstützt werden normale und Streaming-Antworten, tool/function calling, Systemnachrichten, lange Kontexte, reasoning bei kompatiblen Modellen und Vision bei entsprechend markierten Modellen. Modell und Client müssen die jeweilige Funktion unterstützen.

Hermes und OpenClaw können Befehle ausführen und Dateien ändern. Testen Sie zuerst in einem Ordner ohne Geheimnisse, aktivieren Sie Sandbox oder Freigaben für gefährliche Aktionen und erlauben Sie keinen Zugriff auf Produktionsserver.

Häufige Fehler

Fehler	Lösung
401 Invalid API key	Vollständigen Schlüssel ohne doppeltes sk-nr- und ohne Leerzeichen verwenden
/v1/v1/chat/completions	Genau ein /v1 stehen lassen
No pricing available for model	Vollständige Modell-ID einschließlich des Teils vor / verwenden
Das alte Modell bleibt aktiv	Neue Sitzung öffnen; in OpenClaw /model default ausführen
503 Service Unavailable	Anderes Modell testen und den Status prüfen

Prüfen Sie den Schlüssel zuerst mit der minimalen Anfrage aus dem Schnellstart. Offizielle Quellen: Hermes providers und OpenClaw providers.