GateRouter 文档

快速开始

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",
)

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。

安装 OpenClaw

环境要求

OpenClaw 需要 Node.js 22 或更高版本。如果未安装或版本过低，请访问 Node.js 官网 下载安装。

安装方式

macOS/Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)：

iwr -useb https://openclaw.ai/install.ps1 | iex

访问 OpenClaw 官方网站了解更多信息： https://openclaw.ai/

完成初始配置向导

首次安装后，OpenClaw 会自动启动配置向导，帮助您快速完成初始设置。您也可以手动执行 openclaw onboard --install-daemon 命令进行配置。

接入 GateRouter

Web 控制台配置（方式 1）

1. 启动 Web 控制台

在终端中运行以下命令：

openclaw dashboard

2. 进入配置页面

选择 配置 → Raw 模式。

编辑文件配置（方式 2）

macOS：

1. 打开 Finder，快捷键：Command + Shift + G
2. 输入：~/.openclaw
3. 回车，就能看到 openclaw.json。

Windows：

路径：C:\Users\你的用户名\.openclaw\openclaw.json

添加 GateRouter 配置

1. 添加 GateRouter 配置

在 JSON 中添加 env，并将 GATEROUTER_API_KEY 替换为您的 GateRouter API Key：

env: {
    vars: {
      GATEROUTER_API_KEY: 'sk-or-v1-xxxxxxxxxxxxxxxx',
    }
  },

添加 models，将 baseUrl 调整为 https://api.gaterouter.ai/openai/v1：

models: {
  mode: 'merge',
  providers: {
    gaterouter: {
      baseUrl: 'https://api.gaterouter.ai/openai/v1',
      apiKey: '${GATEROUTER_API_KEY}',
      api: 'openai-completions',
      models: [
        {
          id: 'gaterouter/auto',
          name: 'Gaterouter Auto',
          api: 'openai-completions',
          reasoning: false,
          input: ['text'],
          cost: {
            input: 0,
            output: 0,
            cacheRead: 0,
            cacheWrite: 0,
          },
          contextWindow: 200000,
          maxTokens: 8192,
        },
      ],
    },
  },
},

替换原 "agents": {...} 部分为：

agents: {
  defaults: {
    model: {
      primary: 'gaterouter/auto',
    },
    models: {
      'gaterouter/auto': {
        alias: 'Gaterouter Auto',
      },
    },
  },
},

2. 保存并应用配置

Web 控制台：配置完成后，单击右上角 Save 保存配置，再单击 Update。

编辑文件配置：保存并重启 OpenClaw agent。

3. 验证接入成功

在 OpenClaw Chat 界面发送测试问题，例如：Hello。如果配置成功，系统会：调用 GateRouter API → 自动路由到最优模型 → 返回结果。

可选配置

自动模型路由

GateRouter 推荐使用

primary: 'gaterouter/auto'

根据：价格、延迟、可用性，自动选择最优模型。

指定模型

如果需要固定使用某一模型，例如：

primary: 'gaterouter/minimax/minimax-m2.5'

API 参考

端点

可用模型

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

故障排除