CLIProxyAPIPlus 是 CLIProxyAPI 的社群擴展版本,截至 2026 年 3 月已在 GitHub 累積超過 1,200 星標。它的核心能力在於透過 OAuth 認證代理多家 AI 供應商的 API,並將這些異質來源統一為 OpenAI 相容的端點。本文將逐步示範如何設定 CLIProxyAPIPlus,以 OAuth 代理 GPT-5.4(OpenAI 於 2026 年 3 月 5 日發布的最新旗艦模型)作為預設 API,並在額度耗盡時自動切換至 OpenRouter 上的 Kimi K2.5(Moonshot AI 的多模態推理模型),為 OpenClaw 個人 AI Agent 提供穩定且經濟的推論服務。
為什麼需要 API Proxy 加上 Failover?
OpenClaw 是一個開源的個人 AI Agent 平台,支援 WhatsApp、Telegram、Discord、Slack 等超過 20 個訊息平台。它的 Gateway 架構是一個持續運行的 Node.js 程序,負責處理會話管理、工具呼叫、記憶持久化與排程任務。這種「永不關機」的 Agent 模式意味著 API 用量極高,單一供應商的額度很容易在一天內耗盡。
以 ChatGPT Plus 用戶為例,GPT-5.4 Thinking 的每週訊息上限約為 3,000 則。一個活躍的 OpenClaw Agent 透過心跳排程(heartbeat)與多頻道訊息處理,在繁忙時段可能每小時消耗數十次 API 呼叫。沒有 failover 機制的話,Agent 會在額度耗盡後完全停擺。
CLIProxyAPIPlus 的解決方案是:將 OpenAI OAuth 認證與 OpenRouter API Key 同時掛載在同一個 Proxy 服務上,由 Proxy 自動偵測 HTTP 429(Too Many Requests)或 403 錯誤碼後,將後續請求轉送至 OpenRouter 的 Kimi K2.5。
架構總覽
整體架構分為三層:
OpenClaw 只需要知道一個端點(例如 ),CLIProxyAPIPlus 負責在背後處理認證、模型對映與故障切換。
前置準備
在開始設定前,確認以下條件:
硬體需求:任何可持續運行的裝置——Mac mini、Linux VPS、Raspberry Pi 5 或 Windows 桌機。CLIProxyAPIPlus 本身資源消耗極低,2 GB RAM 即足夠。
帳號與 API Key:一個 ChatGPT Plus/Pro 帳號(用於 OAuth 取得 GPT-5.4 存取權),以及一個 OpenRouter 帳號的 API Key(用於存取 Kimi K2.5)。OpenRouter API Key 可在 https://openrouter.ai/keys 取得。
軟體:Docker(建議)或 Go 1.24+(如需從原始碼編譯)。
步驟一:安裝 CLIProxyAPIPlus
Docker 部署是最直接的方式。在終端機執行以下指令:
macOS 用戶也可選擇 Homebrew 安裝主線版本:,但 Plus 版需要使用 Docker 映像 。
步驟二:執行 OpenAI OAuth 登入
CLIProxyAPIPlus 支援 OpenAI Codex 的 OAuth 裝置碼流程,認證成功後即可透過 Proxy 存取 GPT-5.4 系列模型。
終端機會顯示一組認證 URL 和裝置碼。在瀏覽器中開啟該 URL,以你的 ChatGPT 帳號登入並授權。授權完成後,認證 JSON 檔案會自動存入 目錄。
如需註冊多個 OpenAI 帳號以實現負載平衡,重複執行 即可。CLIProxyAPIPlus 會以 round-robin 方式輪替使用這些認證。
步驟三:設定 OpenRouter 作為 Failover 供應商
打開 ,在 區段加入 OpenRouter 設定:
這段設定告訴 CLIProxyAPIPlus:OpenRouter 是一個遵循 OpenAI 相容協定的第三方供應商,其 API 端點為 。
步驟四:設定模型別名與 Failover 路由
CLIProxyAPIPlus 的 功能是實現自動切換的關鍵。透過別名,你可以讓 OpenClaw 請求 時,Proxy 會依序嘗試 OpenAI OAuth 認證,失敗後 fallback 至 OpenRouter 上的 Kimi K2.5。
這段設定的邏輯是:當客戶端(OpenClaw)請求 模型,CLIProxyAPIPlus 首先嘗試透過 OAuth 認證的 OpenAI Codex 端點處理請求。如果收到 403 或 429 回應,Proxy 在設定的重試次數後,將請求轉送至名為 的供應商,使用模型名稱 。
另外需要確保重試與額度切換機制已開啟:
表示遇到 403、408、500、502、503 或 504 錯誤碼時,CLIProxyAPIPlus 會重試最多 3 次。在重試過程中,它會輪替可用的認證檔與供應商,直到找到可回應的端點。
步驟五:設定 Proxy API Key
為 CLIProxyAPIPlus 建立一組 Proxy 層級的 API Key,用於客戶端(OpenClaw)連接:
這個 Key 是 OpenClaw 連接 CLIProxyAPIPlus 時使用的認證,與 OpenAI 或 OpenRouter 的 API Key 無關。
步驟六:設定 OpenClaw 連接 Proxy
OpenClaw 的設定檔位於 。更新模型供應商設定,指向 CLIProxyAPIPlus:
OpenClaw 會將所有 LLM 請求發送至 ,CLIProxyAPIPlus 在背後決定由 OpenAI 或 OpenRouter 處理。OpenClaw 也支援 model fallback 機制:
這等於建立了雙重保險:CLIProxyAPIPlus 層級的 failover 加上 OpenClaw 層級的 fallback。
步驟七:驗證與測試
重啟 CLIProxyAPIPlus 使設定生效:
用 curl 發送測試請求:
正常情況下,回應會來自 GPT-5.4。可以在 Web 管理介面()觀察請求路由記錄。當 OpenAI 額度耗盡時,你會在日誌中看到請求被轉送至 供應商。
GPT-5.4 vs Kimi K2.5:Failover 的效能與成本考量
這個組合的設計邏輯是:GPT-5.4 擔任主力模型處理需要深度推理和長程 Agent 工作流的任務,而當額度限制觸發時,Kimi K2.5 以約 1/4 的成本接手。Kimi K2.5 在 SWE-bench Multilingual 等編碼基準測試中的表現甚至超越了 GPT-5.2,對於 OpenClaw 的多數日常任務而言是足夠稱職的備援。
進階設定:Prefix 隔離與多帳號管理
如果你同時使用多個 OpenAI 帳號和多把 OpenRouter Key,可以用 隔離不同供應商的模型命名空間:
設定 後,OpenClaw 可以透過 明確指定走 OpenRouter 路由,避免與 OAuth 認證的模型名稱衝突。
Web UI 管理介面
CLIProxyAPIPlus v6.8.0 以上版本內建 Web 管理介面,啟動服務後在瀏覽器開啟 。管理介面提供:
透過 Quota 頁面,你可以即時監控 OpenAI OAuth 認證的剩餘額度,預判何時會觸發 failover。
安全性注意事項
CLIProxyAPIPlus 預設僅監聽 ,不對外網開放。如需遠端存取(例如 OpenClaw 運行在不同裝置上),建議使用 Tailscale 或 SSH Tunnel,而非直接開放端口。
額外注意:OpenRouter 預設會將你的 prompt 資料傳送至模型供應商。Kimi K2.5 的供應商是 Moonshot AI(總部位於北京),其隱私政策允許使用發送的資料進行模型訓練。如果資料合規性是你的考量,可以在 OpenRouter 的 provider routing 中指定只使用特定推論供應商(如 Fireworks AI)來服務 Kimi K2.5 的請求。
OpenClaw 的 Agent 如何與 CLIProxyAPIPlus 互動?
OpenClaw Gateway 發出的每一次 LLM 呼叫都遵循 OpenAI Chat Completions API 格式。CLIProxyAPIPlus 接收後,依據模型名稱找到對應的 OAuth 認證或 API Key,將請求翻譯為該供應商的原生格式並轉送。回應同樣被翻譯回 OpenAI 格式,OpenClaw 無需知道背後是哪個供應商在處理。
Kimi K2.5 在 OpenClaw 場景中的實際表現如何?
根據 OpenRouter 平台的社群回報,Kimi K2.5 在 agentic tool-calling 與程式碼生成任務上表現穩定。其 262K token 的上下文窗口對於 OpenClaw 的多輪對話和工具呼叫鏈而言綽綽有餘。主要的差距在於複雜推理任務:GPT-5.4 在 OpenAI 內部的 GDPval 測試中達到 83% 正確率,而 Kimi K2.5 的推理深度定位略低。作為 failover 備援而非主力模型,這個取捨是合理的。
如果 OpenRouter 也出現額度限制怎麼辦?
OpenRouter 的免費額度極為有限,但付費帳號的速率限制遠高於 OpenAI 的消費者方案。你可以在 OpenRouter 帳號中設定帳單上限以控制支出。如果需要更極致的可靠性,可在 中加入第三個供應商(如 Vertex AI 或自建 Ollama 端點)作為最終兜底。
CLIProxyAPIPlus 與主線 CLIProxyAPI 的差異是什麼?
主線版本(CLIProxyAPI,13,400+ 星標)由核心團隊維護,專注於 OAuth 認證供應商(Gemini CLI、Codex、Claude Code、Qwen Code 等)。Plus 版本(CLIProxyAPIPlus,1,200+ 星標)fork 自主線,額外支援第三方供應商(如 OpenRouter、Kiro AWS 等)。Plus 版的功能更新與主線保持同步,但第三方供應商的支援由社群維護者負責。
這套設定可以用於 Claude Code 或其他 AI Coding 工具嗎?
可以。CLIProxyAPIPlus 的 OpenAI 相容端點同時支援 Claude Code、Cline、Cursor、Roo Code 等 AI 編碼工具。只需將這些工具的 API base URL 指向 ,並填入你的 Proxy API Key 即可。
完整 config.yaml 範例
以下是整合 OpenAI OAuth + OpenRouter failover 的完整設定檔範例:
引用來源
- CLIProxyAPIPlus — GitHub Repository
- CLIProxyAPI Official Documentation
- OpenAI — Introducing GPT-5.4
- OpenRouter — Kimi K2.5 Model Card
- OpenRouter — Integration with OpenClaw
- OpenClaw Official Documentation
關於作者
Tenten.co 協助超過 30 家企業客戶建置 AI Agent 基礎架構,包括 Claude Code 工作流整合、OpenRouter 多模型路由策略、以及 OpenClaw 部署與客製化。在實際專案中,我們觀察到單一供應商的 API 額度限制是 Agent 運作中斷的首要原因。這套 CLIProxyAPIPlus + OpenRouter failover 架構源自我們在生產環境中反覆驗證的實踐,可將 Agent 停機時間降至接近零。
若您正在評估 AI Agent 架構或需要整合多模型供應商的 API 代理方案,歡迎與 Tenten 團隊預約諮詢。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/230641.html