掌握 OpenClaw 切換模型的 3 種方法：聊天命令、CLI 和配置文件完整指南

作者注：詳解 OpenClaw 切換大模型的 3 種方法，包括聊天命令 /model 快速切換、CLI 命令行設置、配置文件持久化修改，幫你在 OpenClaw 中自由切換 Claude、GPT、DeepSeek 等模型。

很多用戶安裝好 OpenClaw 後會遇到一個常見問題：我想切換不同的大模型，應該點哪個按鈕？在哪個菜單裏操作？

答案是：OpenClaw 沒有傳統的 GUI 按鈕或下拉菜單來切換模型。作爲一個基於聊天的 AI 助手，OpenClaw 的模型切換完全通過命令完成——可以在聊天框裏輸入命令，也可以在終端中執行 CLI 命令，還可以直接修改配置文件。

核心價值: 讀完本文，你將掌握 OpenClaw 切換模型的 3 種方法，並學會根據不同場景選擇最合適的切換方式。

OpenClaw 切換模型方法總覽

OpenClaw 切換模型的核心邏輯

很多用戶習慣了 ChatGPT、LobeChat 等產品的圖形界面，期望在 OpenClaw 中也能找到一個「模型選擇下拉框」。但 OpenClaw 的設計理念不同——它是一個命令驅動的 AI 助手，集成在 Telegram、Discord、WhatsApp 等聊天平臺中，自然沒有傳統意義上的 GUI 界面。

即使使用 OpenClaw 自帶的 Web UI（通過 openclaw dashboard 打開），模型切換也是在聊天框中輸入命令完成的，而非點擊按鈕。

OpenClaw 聊天命令切換模型（最常用）

這是最簡單、最直接的 OpenClaw 切換模型方式。在任何聊天窗口（Web UI、Telegram、Discord 等）中，直接輸入斜槓命令即可。

基礎命令

OpenClaw 切換模型實操步驟

第一步：查看當前模型

在聊天框中輸入：

/model

系統會返回當前正在使用的模型信息，例如 anthropic/claude-sonnet-4-6。

第二步：查看可用模型列表

/models

系統會列出所有已配置的模型，包括提供商和模型 ID。

第三步：切換到目標模型

/model openai/gpt-5.2

切換成功後，後續對話都會使用新模型，直到你再次切換或開始新會話。

常用的 OpenClaw 模型切換命令

# 切換到 Claude 系列
/model anthropic/claude-sonnet-4-6
/model anthropic/claude-opus-4-6

# 切換到 GPT 系列
/model openai/gpt-5.2
/model openai/gpt-4o-mini

# 切換到 DeepSeek
/model deepseek/deepseek-v3

# 使用自定義提供商（如通過 API易 配置的模型）
/model apiyi/claude-sonnet-4-6
/model apiyi/gpt-5.2

🎯 注意: 通過 /model 命令切換的模型僅在當前會話生效。開始新會話（/new）後會恢復爲默認模型。如果需要永久切換，請使用 CLI 命令或修改配置文件。

OpenClaw CLI 命令行切換模型

如果你希望切換默認模型而不僅僅是當前會話，可以使用 OpenClaw 的 CLI 命令。

CLI 模型管理命令

OpenClaw CLI 切換模型操作示例

打開終端，執行以下命令：

# 查看當前默認模型
openclaw models status

# 列出所有可用模型
openclaw models list

# 切換默認模型爲 Claude Sonnet
openclaw models set anthropic/claude-sonnet-4-6

# 重啓 Gateway 確保生效
openclaw gateway restart

# 1. 先查看當前狀態
openclaw models status
# 輸出: Primary model: anthropic/claude-sonnet-4-6

# 2. 查看所有可用模型
openclaw models list
# 輸出:
# anthropic/claude-sonnet-4-6
# anthropic/claude-opus-4-6
# openai/gpt-5.2
# openai/gpt-4o-mini
# deepseek/deepseek-v3

# 3. 切換到 GPT-5.2
openclaw models set openai/gpt-5.2
# 輸出: Default model set to openai/gpt-5.2

# 4. 重啓 Gateway 確保所有會話生效
openclaw gateway restart
# 輸出: Gateway restarted successfully

# 5. 驗證切換結果
openclaw models status
# 輸出: Primary model: openai/gpt-5.2

建議: 切換默認模型後建議重啓 Gateway（openclaw gateway restart），確保所有聊天渠道都使用新模型。如果你通過 API易 apiyi.com 配置了多個模型提供商，可以在不同模型間快速切換對比效果。

OpenClaw 配置文件修改模型（持久化）

如果需要配置多個模型提供商、設置模型別名或永久修改默認模型，最可靠的方式是直接編輯配置文件。

配置文件位置

OpenClaw 的配置文件路徑爲：

~/.openclaw/openclaw.json

也支持 JSON5 格式：~/.openclaw/openclaw.json5

OpenClaw 配置文件切換模型示例

以下是一個配置多個模型提供商的示例：

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/claude-sonnet-4-6" }
    }
  }，
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1"，
        "apiKey": "sk-your-api-key"，
        "api": "openai-completions"，
        "models": [
          { "id": "claude-sonnet-4-6"， "name": "Claude Sonnet 4.6" }，
          { "id": "claude-opus-4-6"， "name": "Claude Opus 4.6" }，
          { "id": "gpt-5.2"， "name": "GPT-5.2" }，
          { "id": "deepseek-v3"， "name": "DeepSeek V3" }
        ]
      }
    }
  }
}

配置參數說明

修改配置文件後，需要重啓 Gateway 使配置生效：

openclaw gateway restart

🎯 推薦方案: 使用 API易 apiyi.com 作爲統一的模型提供商，一個 API Key 即可調用 Claude、GPT、DeepSeek 等多種模型。在配置文件中只需配置一個 provider，通過 /model 命令即可在所有模型間自由切換。

OpenClaw 切換模型常見問題

總結

OpenClaw 切換模型的核心要點：

1. 沒有 GUI 按鈕：OpenClaw 是命令驅動的 AI 助手，模型切換通過命令完成，不支持鼠標點擊或菜單選擇
2. 聊天命令最快捷：在聊天框輸入 /model <模型ID> 即可臨時切換，適合快速試用
3. CLI + 配置文件最可靠：使用 openclaw models set 或修改 openclaw.json 實現永久切換

如果你需要頻繁在多個模型間切換對比，推薦通過 API易 apiyi.com 配置統一接口，一個 provider 即可調用所有主流模型，省去配置多個 API Key 的麻煩。

📚 參考資料

1. OpenClaw 官方文檔 – 模型配置: 模型切換和提供商配置的詳細說明

   • 鏈接: docs.openclaw.ai/concepts/models
   • 說明: 官方模型管理文檔，包含所有支持的命令和參數

2. OpenClaw 官方文檔 – 模型提供商: 配置自定義 API 提供商的指南

   • 鏈接: docs.openclaw.ai/concepts/model-providers
   • 說明: 詳細介紹如何添加和配置第三方模型提供商

3. OpenClaw GitHub 倉庫: 開源代碼和社區討論

   • 鏈接: github.com/openclaw/openclaw
   • 說明: 查看最新版本、提交問題和參與社區討論

作者: APIYI 技術團隊
技術交流: 歡迎在評論區討論，更多資料可訪問 API易 docs.apiyi.com 文檔中心