連接 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 ​

功能與安全性 ​

常見錯誤 ​