GateRouter Documentation

快速開始

1. 取得 API Key

1. 前往 gaterouter.ai，使用 Gate 帳號登入
2. 進入 Dashboard → 產生 API Key

2. 啟用自動路由（選用）

智慧路由（auto 模型）預設未開啟。開啟方式：

Dashboard → 路由設定 → 開啟 Auto Routing

啟用後，GateRouter 會自動為每個請求選擇最佳模型。若你偏好自行選擇模型，可略過此步驟，直接指定模型（如 anthropic/claude-sonnet-4.6）。

標準接入

相容任何 OpenAI 相容客戶端 — Python、Node.js、Golang、curl、LangChain、LlamaIndex 等。

只需更換 base URL 和 API Key，其他程式碼保持不變。

from openai import OpenAI

client = OpenAI(
    api_key="GATEROUTER_API_KEY",  # get GATEROUTER_API_KEY from gaterouter.ai (API Key)
    base_url="https://api.gaterouter.ai/openai/v1",
)

completion = client.chat.completions.create(
    model="auto",
    messages=[
        {"role": "system", "content": "system prompt"},
        {"role": "user", "content": "how are you?"}
    ],
)

# get the response from LLM (role=assistant)
print(completion.choices[0].message.content)

{
    "id": "243c850e-214c-431e-977f-ebaf4aa95f56",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "你好！很高兴见到你，有什么我可以帮你的吗？😊"
            },
            "finish_reason": "stop"
        }
    ],
    "created": 1773408946,
    "model": "deepseek.v3-v1:0",
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 5,
        "completion_tokens": 15,
        "total_tokens": 20
    }
}

OpenClaw 接入

如果你使用 OpenClaw，GateRouter 可作為 skill 整合。

快速設定

bash {baseDir}/scripts/setup.sh <YOUR_API_KEY> <OPENCLAW_ROOT>

腳本將自動完成：

1. 測試 API 連通性（包含自動路由偵測）
2. 將 API Key 寫入 .env
3. 將 GateRouter provider 新增至 models.json
4. 更新 openclaw.json，將 gaterouter/auto 設為主模型

手動設定

1. 在 OpenClaw 根目錄的 .env 中新增：

GATEROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxx"

2. 更新 openclaw.json：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "gaterouter/auto",
        "fallbacks": [
          "gaterouter/anthropic/claude-sonnet-4.6",
          "openrouter/anthropic/claude-sonnet-4.6"
        ]
      }
    }
  },
  "auth": {
    "profiles": {
      "gaterouter:default": {
        "provider": "gaterouter",
        "mode": "api_key"
      }
    }
  }
}

3. 重新啟動 OpenClaw agent。

API 參考

端點

可用模型

模型 ID 格式：provider/model-name。版本號使用 .（如 4.6），而非 -。

故障排除