GetRouter文件
  • 繁體中文

    • OpenClaw

    整合狀態
    • 建議通訊協定： OpenAI Responses
    • 設定核對日期： 2026 年 7 月 15 日（OpenClaw 官方提供者文件）
    • 執行階段驗證： 待驗證

    OpenClaw 支援在 models.providers 下設定自訂提供者。請使用專用 API 金鑰與完全相符的 GetRouter 模型 ID。

    環境變數

    export GETROUTER_API_KEY="YOUR_API_KEY"

    請透過您的 OpenClaw 安裝方式所建議的環境變數機制保存此設定。請勿將金鑰提交至版本控制。

    提供者設定

    將以下設定新增或合併至您的 OpenClaw 設定檔：

    {
  "models": {
    "mode": "merge",
    "providers": {
      "getrouter": {
        "baseUrl": "https://getrouter.ai/v1",
        "apiKey": "${GETROUTER_API_KEY}",
        "api": "openai-responses",
        "models": [
          {
            "id": "MODEL_ID",
            "name": "GetRouter Model"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "getrouter/MODEL_ID"
      }
    }
  }
}

    將兩處的 MODEL_ID 替換為同一個模型 ID。請保留檔案中其他不相關的既有設定。

    Note

    如果您的 OpenClaw 版本或所選模型無法搭配 Responses 使用，請先查閱該版本的提供者文件，再切換 api 介接器。請勿在未確認的情況下直接修改。

    驗證

    1. 重新啟動 OpenClaw，讓它重新載入設定與環境變數。
    2. 確認目前使用的模型是 getrouter/MODEL_ID。
    3. 傳送簡短的文字提示詞。
    4. 在 GetRouter 用量記錄中確認請求成功。
    5. 在執行無人監督的 Agent 前，另外測試工具呼叫。

    常見錯誤

    • 找不到提供者或模型： 檢查兩處 MODEL_ID 與 getrouter/ 前綴。
    • 401： 確認 OpenClaw 處理程序可存取 GETROUTER_API_KEY。
    • /responses 回應為 404： 提供者目前使用 Responses；請確認 Base URL 完全是 https://getrouter.ai/v1。
    • 文字請求成功但工具失敗： 選擇支援工具呼叫的模型，並確認 OpenClaw 與該模型相容。