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），而非 -。

故障排除