要在 OpenClaw 裡換 AI 模型,最快的方式是用 ZenClaw——OpenClaw 託管服務,9 秒部署,控制台的「切換模型」按鈕點一下就換好。 自架 OpenClaw 的話需要編輯 ~/.openclaw/openclaw.json、準備 API key、重啟 gateway,過程中很容易踩到 JSON 語法錯、key 放錯欄位、restart 後沒生效。這篇把自架改設定、ZenClaw UI 切換、挑模型原則一次講完。
OpenClaw 支援哪些模型?
2026 年 4 月的 OpenClaw 透過內建 provider 以及 LiteLLM 可以接到市面主流的 LLM:Claude(Haiku / Sonnet / Opus)、GPT-4o、Gemini、MiniMax、Kimi 等;方案視等級提供的模型組合,包含 Claude / GPT / Gemini 等主流;NVIDIA Nemotron 相關模型透過 NemoClaw 沙箱整合提供,以定價頁為準。 細節以 OpenClaw 官方文件 為準。社群更新節奏很快,新模型通常發佈沒多久就會有對應的 provider。不同模型的呼叫格式不一樣,但 OpenClaw 抽象成同一組 API,換只要改一個欄位。
值得注意:
- Claude 系列靠 Anthropic API,金鑰從 anthropic.com 申請
- GPT-4o、o-series 靠 OpenAI API
- Gemini 走 Google AI Studio
- Nemotron 通常搭配 NVIDIA 基礎設施效益最好——ZenClaw 方案搭配 NemoClaw 沙箱(NVIDIA 企業級沙箱執行),整合度最高
自架:改 openclaw.json 的完整流程
編輯 ~/.openclaw/openclaw.json 的 model 欄位,放對應 provider 的 API key 到 credentials/,restart gateway 即生效——聽起來簡單,實務上第一次幾乎都會卡一下。 標準步驟:
- 找到設定檔:
ls ~/.openclaw/ # 會看到 openclaw.json、sessions、agents、credentials、skills - 備份後編輯
openclaw.json,把model改成例如"claude-sonnet"或"gpt-4o" - 到
credentials/放對應 provider 的 key(檔名遵循 OpenClaw 慣例) - 重啟 gateway(依你的部署方式,一般可用 systemd / docker restart / openclaw gateway restart 等指令)
- 測一則訊息確認
常見踩雷:
- JSON 語法錯:多一個逗號、漏一個括號都會讓 gateway 起不來
- API key 放錯路徑:不同 provider 的檔案路徑不一樣
- Port 18789 被防火牆擋住自己:導致看起來「沒生效」,實際是連不進去
- 權限問題:
credentials/的檔案權限沒改成 600,gateway 讀不到或曝露風險
參考 OpenClaw gateway security 文件 設好 127.0.0.1 綁定與 token 長度。
ZenClaw 後台:點一下就換(推薦)
在 ZenClaw 控制台的「切換模型」按鈕下拉,選你要的模型按儲存——後端會幫你處理金鑰、reload、失敗回滾,整個體驗是 UI 點擊。 實際步驟:
- 登入 zenclaw.ai,按「立即雇用 AI 員工」
- 若還沒部署,按「新增 OpenClaw 安裝」等 9 秒
- 在實例卡片找到「模型」區塊,下拉選目標模型
- 儲存後立刻在 Telegram / LINE / Microsoft Teams 測試
ZenClaw 已內建以下好處:
- 金鑰管理:ZenClaw 透過自家 LiteLLM proxy(
litellm.mixerbox.ai)幫你托管上游 API key,你不用自己申請、輪替 OpenRouter / Anthropic / OpenAI key - 設定檔自動保留:OpenClaw 寫入設定前會留下
.bak備份,若配置損壞,doctor-fix 可從備份還原 - 方案額度、帳單可預期:Business 方案月薪 1 萬 / 2 萬 / 3 萬都包含模型使用額度,不是看你自己燒 token——自架比較容易遇到 agent 進 loop 或高頻呼叫 skill 導致帳單一夜爆掉,ZenClaw 方案內含額度,超過自動停
- 方案分級提供模型組合:依方案等級提供 Claude Haiku / Sonnet / Opus、GPT、Gemini、Nemotron 等主流模型組合,省去自己 vet 每個 provider 的時間
怎麼挑模型?三個常見場景
大多數情境從 Sonnet / GPT-4o 中階起跳,遇到便宜量大切 Haiku,需要複雜推理切 Opus;Nemotron 適合 NVIDIA 基礎設施跑沙箱。 對照表:
| 場景 | 建議模型 | 原因 |
|---|---|---|
| 一般 chatbot 客服 | Claude Haiku / Sonnet、GPT-4o mini | 速度快、費用低、品質夠用 |
| 訂單自動化、複雜決策 | Claude Sonnet、GPT-4o | 推理 / 工具使用穩定 |
| 法規文件分析、長報告 | Claude Opus | 長上下文、推理更強 |
| NVIDIA 企業沙箱 | Nemotron(搭 NemoClaw 沙箱) | 整合最順 |
| 中文 / 多語內容 | Claude Sonnet、Kimi、MiniMax | 中文能力強 |
費用部分,Claude Opus 比 Haiku 的單位 token 費率可以高數倍到十幾倍(詳見 Anthropic pricing),跑量大前記得確認。
容易踩的雷(自架 vs ZenClaw)
自架最常見是 JSON 改壞、API key 忘了換、gateway 沒 reload;ZenClaw 這三題都由後端處理掉。 自架檢查清單:
- 改完 JSON 先
jq . openclaw.json驗語法 - 新 provider key 放對目錄 + 權限 600
curl http://127.0.0.1:18789/health確認 gateway 活著- 換到更強的模型(如 Opus)之前算一下每日帳單上限,避免跑量失控(見 API bill runaway 預防)
ZenClaw 對應:
- 後台依方案等級提供可用模型組合,不會誤設
- 方案內含額度,帳單不會爆
- 失敗會 fallback 到上一個設定
- Telegram / LINE / Microsoft Teams 管道設定也是點擊綁定
結論
換模型在 OpenClaw 是一行 JSON 的事,但自架要處理金鑰、reload、回滾;ZenClaw 的後台點一下就換好。 不想把週末花在 debug openclaw.json 上,就用 ZenClaw——首頁「立即雇用 AI 員工」按下去 9 秒就能開始,之後換模型永遠只是一次點擊。