1069 字
5 分鐘
OpenClaw (原 Moltbot) CLI 模型切換失敗?修改 agents.defaults.models 配置全解

🚨 重要警告(2026/02 更新):本文範例使用的 google-antigravity provider,筆者本人已因透過 OpenClaw 呼叫而遭 Google 帳號永久封禁(fban)。強烈建議不要再使用 Antigravity provider,改用 NVIDIA Build API 接入 Kimi K2.5 等替代方案。

⚠️ 更新提示:本專案 (Moltbot) 已於 2026/01/30 正式更名為 OpenClaw。本文技術內容依然適用,但部分指令名稱可能有所變動。關於更名細節與新功能,請參考:OpenClaw 正式更名懶人包

2026/01 更新:本工具已從 Clawdbot 改名為 Moltbot(因 Anthropic 商標問題)。 如果你是搜尋 Clawdbot 找到這篇,你來對地方了!npm 套件已改為 moltbot,但舊版 clawdbot 指令目前仍可使用,配置路徑目前仍是 ~/.clawdbot/。 本文指令以 moltbot 為主,如果你還在用舊版,請自行替換為 clawdbot

問題描述#

使用 Moltbot(原 Clawdbot)CLI 一段時間後,你可能會遇到這種情況:

  • 原本使用 google-antigravity/gemini-3-flash 用到 token 額度耗盡
  • 想切換到其他模型(如 claude-sonnet-4-5
  • 執行 /model google-antigravity/claude-sonnet-4-5 卻發現無法使用
  • 或是在 /models 列表中根本看不到想要的模型

這不是 bug,而是 Moltbot 的設計機制。

問題根源#

當你第一次執行 moltbot onboard 設定嚮導時,選擇的模型會被寫入配置檔的 agents.defaults.models 區段。這個區段是一個模型允許列表(Allowlist)——只有明確列出的模型才能使用。

查看你的配置:

Terminal window
cat ~/.clawdbot/clawdbot.json | jq '.agents.defaults.models'

你可能會看到類似這樣的輸出:

{
"google-antigravity/claude-opus-4-5-thinking": {},
"google-antigravity/gemini-3-flash": {}
}

這就是為什麼你只能用這兩個模型——其他模型根本不在允許列表中。

配置檔案位置#

Moltbot 的配置分為兩個層級:

檔案用途
~/.clawdbot/clawdbot.json主配置檔agents.defaults.models 在這裡
~/.clawdbot/agents/<agentId>/models.jsonAgent 專屬模型配置(進階用法)

注意:配置路徑目前仍是 ~/.clawdbot/,尚未改為 ~/.moltbot/

大多數情況下,你只需要修改主配置檔即可。

解決方案#

方法一:手動編輯配置(推薦)#

這是最直接的方式,讓你完全掌控可用的模型列表。

步驟 1:打開配置檔

Terminal window
# 使用 VS Code
code ~/.clawdbot/clawdbot.json
# 或使用 nano
nano ~/.clawdbot/clawdbot.json

步驟 2:找到 agents.defaults.models 區段,加入想要的模型

{
"agents": {
"defaults": {
"models": {
"google-antigravity/claude-opus-4-5-thinking": {},
"google-antigravity/gemini-3-flash": {},
"google-antigravity/claude-sonnet-4-5": {},
"google-antigravity/claude-sonnet-4-5-thinking": {},
"google-antigravity/gemini-3-pro-high": {},
"google-antigravity/gemini-3-pro-low": {},
"google-antigravity/gpt-oss-120b-medium": {}
}
}
}
}

步驟 3:儲存檔案並重啟 daemon

Terminal window
moltbot daemon restart

方法二:使用 CLI 命令#

如果不想手動編輯 JSON,可以用 CLI 命令操作:

Terminal window
# 新增模型別名
moltbot models aliases add sonnet google-antigravity/claude-sonnet-4-5
# 查看可用模型列表
moltbot models list
# 設定主要模型
moltbot models set google-antigravity/claude-sonnet-4-5
# 查看模型狀態
moltbot models status

方法三:移除限制(開放全部模型)#

如果你想讓所有模型都可用,可以將 agents.defaults.models 設為空物件:

{
"agents": {
"defaults": {
"models": {}
}
}
}

或直接移除整個 models 區段。

注意:這會讓所有提供者的模型都可用,可能會看到非常長的模型列表。

驗證設定#

修改配置後,執行以下步驟確認設定生效:

Terminal window
# 1. 重啟 daemon(必要!)
moltbot daemon restart
# 2. 查看模型狀態
moltbot models status
# 3. 在聊天中測試
/models
/model google-antigravity/claude-sonnet-4-5

常見問題#

Q: 修改後還是無法使用新模型?#

A: 請確認:

  1. daemon 已重啟:執行 moltbot daemon restart
  2. JSON 格式正確:可以用 cat ~/.clawdbot/clawdbot.json | jq . 驗證
  3. auth profile 正確:執行 moltbot models auth status 檢查驗證狀態

Q: 如何知道有哪些模型可用?#

A: 執行 moltbot models scan 可以掃描 OpenRouter 的免費模型目錄。

Q: 每次 onboard 都會覆蓋設定嗎?#

A: 是的,重新執行 moltbot onboard 可能會覆蓋你的自訂設定。建議先備份配置檔:

Terminal window
cp ~/.clawdbot/clawdbot.json ~/.clawdbot/clawdbot.json.bak

總結#

  • agents.defaults.models 是 Moltbot 的模型允許列表,這是設計功能而非 bug
  • 手動編輯 ~/.clawdbot/clawdbot.json 是最直接的方式
  • 修改後記得執行 moltbot daemon restart 讓設定生效
  • 建議根據實際需求適度開放模型,而非全開
  • 想嘗試更多模型?可以透過 NVIDIA Build 免費 API 在 OpenClaw 接入 Kimi K2.5 並建立隔離顧問代理
  • 從 Clawdbot 遷移過來的用戶,設定路徑可能不同,建議先參考遷移指南確認

參考來源:

Moltbot Models Documentation

Moltbot GitHub

OpenClaw (原 Moltbot) CLI 模型切換失敗?修改 agents.defaults.models 配置全解
https://laplusda.com/posts/openclaw-model-configuration/
作者
Zero
發佈於
2026-01-26
許可協議
CC BY-NC-SA 4.0
這篇文章有幫助嗎?

回報錯字、失效連結,或告訴我你想看的延伸主題。