Conectar Hermes, OpenClaw y otros agentes de IA

Hermes Agent, OpenClaw y la mayoría de los agentes de terceros pueden usar NordRouter como proveedor OpenAI-compatible. No necesitas una suscripción del desarrollador del agente: las solicitudes se cobran del saldo de NordRouter según el uso real.

Datos de conexión

Campo	Valor
Base URL en Rusia	https://nordrouter.com/v1
Fuera de Rusia o con VPN	https://global-api.nordrouter.com/v1
Servidor europeo	https://europe-api.nordrouter.com/v1
API Key	la clave completa sk-nr-… del panel
Model ID	por ejemplo anthropic/claude-sonnet-4.6

Conserva /v1 al final de la Base URL y copia el ID completo desde el catálogo.

Hermes Agent

Hermes Agent admite endpoints OpenAI-compatible personalizados.

Configuración con el asistente

Sal de la sesión activa de Hermes y ejecuta:

hermes model

Elige Custom endpoint (self-hosted / VLLM / etc.) e introduce:

• API base URL: https://nordrouter.com/v1
• API key: tu clave sk-nr-… sin prefijos adicionales
• Model name: anthropic/claude-sonnet-4.6
• Context window: 1000000

Abre una sesión nueva después de guardar. /model dentro del chat solo cambia entre proveedores ya configurados; un endpoint nuevo se añade con hermes model desde el terminal.

Configuración manual

Actualiza el bloque 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

No uses la variable antigua LLM_MODEL: las versiones actuales toman config.yaml como fuente de verdad. Los modelos auxiliares con auto usan el modelo principal; las sustituciones explícitas para vision, compression o subagents también necesitan un endpoint compatible.

OpenClaw

OpenClaw añade proveedores personalizados mediante models.providers.

1. Guarda la clave por separado

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

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

No guardes la clave en el .env de un proyecto ni la subas a Git.

2. Añade el proveedor

Combina este objeto con tu ~/.openclaw/openclaw.json. No reemplaces los canales, herramientas o agentes existentes:

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

Para otra modelo, añade a models otro objeto con su ID público completo.

3. Comprueba la configuración

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

Si la CLI solicita un reinicio, ejecuta openclaw gateway restart --safe. Para diagnóstico usa openclaw logs --follow.

Otros agentes de IA

Si una aplicación ofrece Custom provider, OpenAI Compatible, Custom OpenAI o Chat Completions, introduce la Base URL, la clave y el Model ID de la tabla. La aplicación debe añadir /chat/completions por sí sola.

Si solo permite iniciar sesión en una cuenta oficial de OpenAI o Anthropic y no deja cambiar la Base URL, no puede conectarse directamente a NordRouter.

Funciones y seguridad

Funcionan las respuestas normales y streaming, tool/function calling, mensajes de sistema, contexto largo, reasoning en modelos compatibles y Vision en los modelos marcados en el catálogo. La función debe estar admitida tanto por el modelo como por el cliente.

Hermes y OpenClaw pueden ejecutar comandos y modificar archivos. Haz la primera prueba en una carpeta sin secretos, activa sandbox o la aprobación de acciones peligrosas y no concedas acceso a producción.

Errores frecuentes

Error	Solución
401 Invalid API key	Usa la clave completa sin duplicar sk-nr- ni añadir espacios
/v1/v1/chat/completions	Deja exactamente un /v1
No pricing available for model	Usa el ID completo, incluida la parte anterior a /
Sigue apareciendo el modelo anterior	Abre una sesión nueva; en OpenClaw ejecuta /model default
503 Service Unavailable	Prueba otro modelo y revisa el estado

Verifica primero la clave con la solicitud mínima del inicio rápido. Documentación oficial: Hermes providers y OpenClaw providers.