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. 按 Enter，即可看到 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），而非 -。

故障排除