OpenClaw 模型設定指南：快速切換與自訂 API

每次想換個模型測試效果，都要翻遍設定檔改 API Key 或模型名稱，真的很煩人。如果你也在糾結該選哪款模型，或者想在不同場景快速切換，這篇指南會幫你搞定 OpenClaw 的模型配置。

模型選擇與別名 (Model Selection & Aliases)

在 OpenClaw 中選擇與設定模型。

什麼是「預設模型」？

OpenClaw 的預設模型就是你在這裡設定的內容：

agents.defaults.model.primary

模型引用格式為 provider/model（例如：anthropic/claude-opus-4-5）。

我推薦哪款模型？

推薦預設： anthropic/claude-opus-4-5
不錯的替代方案： anthropic/claude-sonnet-4-5
穩定（但個性較少）： openai/gpt-5.2
預算有限： zai/glm-4.7

經驗法則：高難度工作用你負擔得起的最強模型，日常聊天或摘要用便宜的就好。

⚠️ 強烈警告： 較弱或過度量化的模型更容易受到 prompt injection 攻擊，安全性較低。

我可以使用自託管模型嗎 (llama.cpp, vLLM, Ollama)？

可以。如果你的本地伺服器提供相容 OpenAI 的 API，你可以將自定義 provider 指向它。Ollama 是直接支援的，也是最簡單的路徑。

安全提示： 小型或重度量化的模型更容易受到 prompt injection 攻擊。我們強烈建議為任何可以使用 tool 的機器人配置大型模型。

如何在不清空設定的情況下切換模型？

安全選項：

在聊天中使用 /model（快速，僅限當前 session）
openclaw models set ...（僅更新模型設定）
openclaw configure --section models（互動式介面）
編輯 ~/.openclaw/openclaw.json 中的 agents.defaults.model

除非你想替換整個設定，否則請避免使用帶有部分物件的 config.apply。

如何即時切換模型（無需重啟）？

直接發送 /model 命令作為獨立訊息：

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

你可以用 /model、/model list 或 /model status 列出可用模型。

按數字選擇：

/model 3

你也可以強制指定特定的 auth profile：

/model opus@anthropic:default
/model opus@anthropic:work

我可以將 GPT 5.2 用於日常任務，並將 Codex 5.2 用於寫程式嗎？

可以。

方案 A：按 session 切換 將其中一個設為預設，需要時切換：

/model gpt-5.2      # for daily tasks
/model gpt-5.2-codex  # for coding

方案 B：子代理 (sub-agents) 將寫程式任務路由到具有不同預設模型的 sub-agents。

為什麼我看到「Model … is not allowed」後就沒有回應了？

如果設定了 agents.defaults.models，它就會變成 /model 和任何 session 覆蓋的允許清單 (allowlist)。選擇不在清單中的模型會回傳錯誤。

修復方法： 將模型加入 agents.defaults.models，移除允許清單，或從 /model list 中挑選模型。

為什麼我看到「Unknown model: minimax/MiniMax-M2.1」？

這代表 provider 尚未設定（找不到 MiniMax 的 provider 設定或 auth profile）。

修復檢查清單：

確保已設定 MiniMax（透過 wizard 或 JSON）
使用正確的模型 ID（區分大小寫）：minimax/MiniMax-M2.1
執行 openclaw models list 並從清單中選擇

opus / sonnet / gpt 是內建的捷徑嗎？

是的。OpenClaw 內建了一些預設簡寫：

opus → anthropic/claude-opus-4-5
sonnet → anthropic/claude-sonnet-4-5
gpt → openai/gpt-5.2
gpt-mini → openai/gpt-5-mini
gemini → google/gemini-3-pro-preview
gemini-flash → google/gemini-3-flash-preview

如果你設定了同名的 alias，你的設定會優先。

如何定義或覆蓋模型捷徑 (aliases)？

Alias 來自 agents.defaults.models.<modelId>.alias：

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-5" },
      models: {
        "anthropic/claude-opus-4-5": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" }
      }
    }
  }
}

如何加入來自 OpenRouter 或 Z.AI 等其他供應商的模型？

OpenRouter:

{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} }
    }
  },
  env: { OPENROUTER_API_KEY: "sk-or-..." }
}

Z.AI:

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-4.7" },
      models: { "zai/glm-4.7": {} }
    }
  },
  env: { ZAI_API_KEY: "..." }
}

想要更輕鬆地完成設定？試試我們的 AI Setup Assistant。

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。