Conectar Hermes, OpenClaw e outros agentes de IA

Hermes Agent, OpenClaw e a maioria dos agentes de terceiros podem usar o NordRouter como provedor OpenAI-compatible. Você não precisa de uma assinatura do desenvolvedor do agente: as solicitações são cobradas do saldo NordRouter conforme o uso real.

Dados de conexão

Campo	Valor
Base URL na Rússia	https://nordrouter.com/v1
Fora da Rússia ou com VPN	https://global-api.nordrouter.com/v1
Servidor europeu	https://europe-api.nordrouter.com/v1
API Key	chave completa sk-nr-… do painel
Model ID	por exemplo anthropic/claude-sonnet-4.6

Mantenha /v1 no fim da Base URL e copie o ID completo do catálogo.

Hermes Agent

Hermes Agent aceita endpoints OpenAI-compatible personalizados.

Configuração pelo assistente

Saia da sessão ativa do Hermes e execute:

hermes model

Escolha Custom endpoint (self-hosted / VLLM / etc.) e informe:

• API base URL: https://nordrouter.com/v1
• API key: sua chave sk-nr-… sem prefixo adicional
• Model name: anthropic/claude-sonnet-4.6
• Context window: 1000000

Abra uma nova sessão após salvar. /model dentro do chat apenas alterna provedores já configurados; adicione um endpoint novo com hermes model no terminal.

Configuração manual

Atualize o bloco model em ~/.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ão use a variável antiga LLM_MODEL: as versões atuais usam config.yaml como fonte principal. Modelos auxiliares em auto seguem o modelo principal; substituições explícitas para vision, compression ou subagents precisam de um endpoint compatível.

OpenClaw

OpenClaw adiciona provedores personalizados por models.providers.

1. Guarde a chave separadamente

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

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Não coloque a chave no .env de um projeto nem a envie ao Git.

2. Adicione o provedor

Mescle este objeto com o seu ~/.openclaw/openclaw.json. Não substitua canais, ferramentas ou 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 outra modelo, acrescente a models um objeto com o ID público completo.

3. Valide

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

Se a CLI solicitar reinício, execute openclaw gateway restart --safe. Para diagnóstico, use openclaw logs --follow.

Outros agentes de IA

Se o aplicativo oferecer Custom provider, OpenAI Compatible, Custom OpenAI ou Chat Completions, preencha a Base URL, a chave e o Model ID da tabela. O próprio aplicativo deve acrescentar /chat/completions.

Se ele permitir apenas login em uma conta oficial OpenAI ou Anthropic e não aceitar outra Base URL, não poderá se conectar diretamente ao NordRouter.

Recursos e segurança

Funcionam respostas comuns e streaming, tool/function calling, mensagens de sistema, contexto longo, reasoning em modelos compatíveis e Vision nos modelos marcados no catálogo. O recurso precisa ser suportado pelo modelo e pelo cliente.

Hermes e OpenClaw podem executar comandos e alterar arquivos. Faça o primeiro teste em uma pasta sem segredos, ative sandbox ou aprovação de ações perigosas e não conceda acesso ao ambiente de produção.

Erros comuns

Erro	Solução
401 Invalid API key	Use a chave completa sem repetir sk-nr- e sem espaços
/v1/v1/chat/completions	Mantenha exatamente um /v1
No pricing available for model	Use o ID completo, incluindo a parte antes de /
O modelo antigo continua ativo	Abra uma nova sessão; no OpenClaw execute /model default
503 Service Unavailable	Tente outra modelo e consulte o status

Primeiro valide a chave com a solicitação mínima do início rápido. Documentação oficial: Hermes providers e OpenClaw providers.