Connecter Hermes, OpenClaw et d’autres agents IA

Hermes Agent, OpenClaw et la plupart des agents tiers peuvent utiliser NordRouter comme fournisseur compatible OpenAI. Aucun abonnement auprès du développeur de l’agent n’est nécessaire : les requêtes sont débitées du solde NordRouter selon l’utilisation réelle.

Paramètres de connexion

Champ	Valeur
Base URL en Russie	https://nordrouter.com/v1
Hors de Russie ou avec un VPN	https://global-api.nordrouter.com/v1
Serveur européen	https://europe-api.nordrouter.com/v1
API Key	clé complète sk-nr-… du tableau de bord
Model ID	par exemple anthropic/claude-sonnet-4.6

Conservez /v1 à la fin de la Base URL et copiez l’ID complet depuis le catalogue.

Hermes Agent

Hermes Agent accepte les endpoints personnalisés compatibles OpenAI.

Configuration avec l’assistant

Quittez la session Hermes active puis exécutez :

hermes model

Choisissez Custom endpoint (self-hosted / VLLM / etc.) et saisissez :

• API base URL : https://nordrouter.com/v1
• API key : votre clé sk-nr-… sans préfixe supplémentaire
• Model name : anthropic/claude-sonnet-4.6
• Context window : 1000000

Ouvrez une nouvelle session après l’enregistrement. Dans un chat, /model ne fait que basculer entre les fournisseurs déjà configurés ; ajoutez un nouvel endpoint avec hermes model dans le terminal.

Configuration manuelle

Mettez à jour le bloc model de ~/.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

N’utilisez pas l’ancienne variable LLM_MODEL : les versions récentes utilisent config.yaml comme source de vérité. Les modèles auxiliary en auto suivent le modèle principal ; les remplacements explicites pour vision, compression ou subagents nécessitent aussi un endpoint compatible.

OpenClaw

OpenClaw ajoute les fournisseurs personnalisés via models.providers.

1. Stocker la clé séparément

Créez ~/.openclaw/.env (Windows : %USERPROFILE%\.openclaw\.env) :

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Ne placez pas la clé dans le .env d’un projet et ne l’envoyez pas dans Git.

2. Ajouter le fournisseur

Fusionnez cet objet avec votre ~/.openclaw/openclaw.json. Ne remplacez pas les canaux, outils ou agents existants :

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

Pour un autre modèle, ajoutez dans models un objet avec son ID public complet.

3. Valider

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

Si la CLI demande un redémarrage, exécutez openclaw gateway restart --safe. Pour le diagnostic, utilisez openclaw logs --follow.

Autres agents IA

Si l’application propose Custom provider, OpenAI Compatible, Custom OpenAI ou Chat Completions, saisissez la Base URL, la clé et le Model ID du tableau. L’application doit ajouter elle-même /chat/completions.

Si elle permet uniquement une connexion à un compte officiel OpenAI ou Anthropic sans modification de la Base URL, elle ne peut pas se connecter directement à NordRouter.

Fonctions et sécurité

Les réponses normales et streaming, tool/function calling, messages système, contexte long, reasoning sur les modèles compatibles et Vision sur les modèles marqués sont pris en charge. La fonction doit être acceptée à la fois par le modèle et le client.

Hermes et OpenClaw peuvent exécuter des commandes et modifier des fichiers. Faites le premier test dans un dossier sans secrets, activez une sandbox ou la validation des actions dangereuses et n’accordez aucun accès à la production.

Erreurs fréquentes

Erreur	Solution
401 Invalid API key	Utilisez la clé complète sans doubler sk-nr- et sans espaces
/v1/v1/chat/completions	Gardez exactement un /v1
No pricing available for model	Utilisez l’ID complet, y compris la partie avant /
L’ancien modèle reste actif	Ouvrez une nouvelle session ; dans OpenClaw, exécutez /model default
503 Service Unavailable	Essayez un autre modèle et consultez le statut

Validez d’abord la clé avec la requête minimale du démarrage rapide. Sources officielles : Hermes providers et OpenClaw providers.