使用 Kilo Gateway 統一管理你的 AI 模型存取

串接多個 AI 模型時，最煩人的就是處理各種不同的 API 規格和管理一堆金鑰。每次切換模型都要改程式碼或環境變數，搞得開發流程變得很破碎，原本想專注在功能實作，最後卻花了一堆時間在看各家廠商的文檔。

Kilo Gateway 提供了一個統一的 API，讓你透過單一的 Endpoint 和 API key 就能路由到多個模型。它與 OpenAI 相容，所以你現有的 OpenAI SDK 只要更換 Base URL 就能直接運作。

需要準備的東西

• app.kilo.ai 的帳號
• 一組有效的 Kilo API key

快速開始

1. 取得 API key：前往 app.kilo.ai 登入或註冊，導覽至 API Keys 頁面並產出一組新的金鑰。
2. 設定 CLI：你可以執行 openclaw onboard --kilocode-api-key <key>，或是直接設定環境變數：

   export KILOCODE_API_KEY="<your-kilocode-api-key>" # pragma: allowlist secret

3. 套用配置：在你的設定檔中加入以下 snippet：

   {
     env: { KILOCODE_API_KEY: "<your-kilocode-api-key>" }, // pragma: allowlist secret
     agents: {
       defaults: {
         model: { primary: "kilocode/kilo/auto" },
       },
     },
   }

4. 使用預設模型：預設模型為 kilocode/kilo/auto，這是一個智慧路由模型。它會根據任務自動選擇：
   • 規劃、除錯與編排任務會路由至 Claude Opus
   • 程式碼撰寫與探索任務會路由至 Claude Sonnet

疑難排解

• 模型呼叫失敗：請檢查你的模型引用格式是否正確。所有透過 Gateway 存取的模型都必須加上 kilocode/ 前綴，例如 kilocode/anthropic/claude-sonnet-4。
• 不確定有哪些模型可用：OpenClaw 在啟動時會動態偵測可用模型。你可以輸入 /models kilocode 來查看你帳號目前權限下可以使用的完整模型清單。

想要自動化你的開發流程？或是遇到設定問題？請詢問 AI Setup Assistant。

下一步

• Model Providers 概念說明