连接 Hermes、OpenClaw 和其他 AI Agent

Hermes Agent、OpenClaw 以及大多数第三方 AI Agent 都可以将 NordRouter 配置为 OpenAI-compatible 提供商。无需购买 Agent 开发者的订阅；请求会按照实际用量从 NordRouter 余额中扣费。

连接参数

字段	值
俄罗斯 Base URL	`https://nordrouter.com/v1`
俄罗斯境外或使用 VPN	`https://global-api.nordrouter.com/v1`
欧洲服务器	`https://europe-api.nordrouter.com/v1`
API Key	控制台中的完整 `sk-nr-…` 密钥
Model ID	例如 `anthropic/claude-sonnet-4.6`

Base URL 末尾需要保留 /v1。请从模型目录完整复制模型 ID。

Hermes Agent

Hermes Agent 支持自定义 OpenAI-compatible endpoint。

使用向导

退出当前 Hermes 会话，然后运行：

bash

hermes model

选择 Custom endpoint (self-hosted / VLLM / etc.)，并填写：

API base URL：https://nordrouter.com/v1
API key：完整的 sk-nr-…，不要添加额外前缀
Model name：anthropic/claude-sonnet-4.6
Context window：1000000

保存后启动新会话。聊天中的 /model 只能切换已经配置的提供商；新的 endpoint 必须通过终端中的 hermes model 添加。

手动配置

编辑 ~/.hermes/config.yaml 中的 model：

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

不要使用旧的 LLM_MODEL 变量；当前 Hermes 以 config.yaml 为配置来源。值为 auto 的 auxiliary 模型会使用主模型；如果你单独覆盖了 vision、compression 或 subagents，则也需要配置兼容的 endpoint。

OpenClaw

OpenClaw 通过 models.providers 添加自定义提供商。

1. 单独保存密钥

创建全局文件 ~/.openclaw/.env（Windows：%USERPROFILE%\.openclaw\.env）：

dotenv

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

不要把密钥放进项目级 .env，也不要提交到 Git。

2. 添加提供商

将下面的结构合并到已有的 ~/.openclaw/openclaw.json。不要覆盖原有的频道、工具或 Agent 设置：

json

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

如需其他模型，请把包含完整公开 ID 的对象追加到 models 数组。

3. 验证

bash

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

如果 CLI 要求重启，请运行 openclaw gateway restart --safe。可使用 openclaw logs --follow 查看诊断日志。

其他 AI Agent

只要应用提供 Custom provider、OpenAI Compatible、Custom OpenAI 或 Chat Completions，就填写上表中的 Base URL、密钥和完整 Model ID。应用应自行追加 /chat/completions，不要把该路径写进 Base URL。

如果应用只允许登录官方 OpenAI 或 Anthropic 账户，而且不能更改 Base URL，就无法直接连接 NordRouter。

功能与安全

支持普通与流式响应、tool/function calling、系统消息、长上下文、兼容模型的 reasoning，以及目录中标记为 Vision 的模型。功能必须同时得到模型和客户端支持。

Hermes 和 OpenClaw 可以执行命令与修改文件。首次测试应使用不含密钥的目录，开启 sandbox 或危险操作确认，并且不要授予 production 服务器权限。

常见错误

错误	解决方法
`401 Invalid API key`	使用完整密钥，不要重复 `sk-nr-`，不要带空格
`/v1/v1/chat/completions`	Base URL 只保留一个 `/v1`
`No pricing available for model`	使用包含 `/` 前缀部分的完整模型 ID
仍然使用旧模型	新建会话；OpenClaw 中运行 `/model default`
`503 Service Unavailable`	尝试其他模型并查看状态

先用快速开始中的最小请求验证密钥。官方资料：Hermes providers 和 OpenClaw providers。

连接 Hermes、OpenClaw 和其他 AI Agent ​

连接参数 ​

Hermes Agent ​

使用向导 ​

手动配置 ​

OpenClaw ​

1. 单独保存密钥 ​

2. 添加提供商 ​

3. 验证 ​

其他 AI Agent ​

功能与安全 ​

常见错误 ​