Collegare Hermes, OpenClaw e altri agenti IA

Hermes Agent, OpenClaw e la maggior parte degli agenti di terze parti possono usare NordRouter come provider OpenAI-compatible. Non serve un abbonamento dello sviluppatore dell’agente: le richieste vengono addebitate sul saldo NordRouter in base all’uso effettivo.

Dati di connessione

Campo	Valore
Base URL in Russia	https://nordrouter.com/v1
Fuori dalla Russia o con VPN	https://global-api.nordrouter.com/v1
Server europeo	https://europe-api.nordrouter.com/v1
API Key	chiave completa sk-nr-… dal pannello
Model ID	ad esempio anthropic/claude-sonnet-4.6

Mantieni /v1 alla fine della Base URL e copia l’ID completo dal catalogo.

Hermes Agent

Hermes Agent supporta endpoint OpenAI-compatible personalizzati.

Configurazione guidata

Esci dalla sessione Hermes attiva ed esegui:

hermes model

Scegli Custom endpoint (self-hosted / VLLM / etc.) e inserisci:

• API base URL: https://nordrouter.com/v1
• API key: la tua chiave sk-nr-… senza prefissi aggiuntivi
• Model name: anthropic/claude-sonnet-4.6
• Context window: 1000000

Apri una nuova sessione dopo il salvataggio. /model nella chat cambia solo provider già configurati; aggiungi un endpoint nuovo dal terminale con hermes model.

Configurazione manuale

Aggiorna il blocco 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

Non usare la vecchia variabile LLM_MODEL: le versioni attuali usano config.yaml come fonte principale. I modelli auxiliary su auto seguono il modello principale; override espliciti per vision, compression o subagents richiedono anch’essi un endpoint compatibile.

OpenClaw

OpenClaw aggiunge provider personalizzati tramite models.providers.

1. Conservare la chiave separatamente

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

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Non mettere la chiave nel .env di un progetto e non inviarla a Git.

2. Aggiungere il provider

Unisci questo oggetto al tuo ~/.openclaw/openclaw.json. Non sostituire canali, strumenti o agenti esistenti:

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

Per un altro modello, aggiungi a models un oggetto con il suo ID pubblico completo.

3. Verificare

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

Se la CLI richiede il riavvio, esegui openclaw gateway restart --safe. Per la diagnostica usa openclaw logs --follow.

Altri agenti IA

Se l’app offre Custom provider, OpenAI Compatible, Custom OpenAI o Chat Completions, inserisci Base URL, chiave e Model ID della tabella. L’app deve aggiungere autonomamente /chat/completions.

Se permette soltanto l’accesso con un account ufficiale OpenAI o Anthropic e non consente di cambiare Base URL, non può collegarsi direttamente a NordRouter.

Funzioni e sicurezza

Sono supportati risposte normali e streaming, tool/function calling, messaggi di sistema, contesto lungo, reasoning sui modelli compatibili e Vision sui modelli contrassegnati. La funzione deve essere supportata sia dal modello sia dal client.

Hermes e OpenClaw possono eseguire comandi e modificare file. Esegui il primo test in una cartella senza segreti, attiva sandbox o conferma delle azioni pericolose e non concedere accesso alla produzione.

Errori comuni

Errore	Soluzione
401 Invalid API key	Usa la chiave completa senza ripetere sk-nr- e senza spazi
/v1/v1/chat/completions	Mantieni esattamente un /v1
No pricing available for model	Usa l’ID completo, compresa la parte prima di /
Rimane attivo il vecchio modello	Apri una nuova sessione; in OpenClaw esegui /model default
503 Service Unavailable	Prova un altro modello e controlla lo stato

Verifica prima la chiave con la richiesta minima dell’avvio rapido. Fonti ufficiali: Hermes providers e OpenClaw providers.