OpenClaw /model指令切換沒反應？這個已知Bug的解法讓你秒修
已確認的 Bug：在 2026.1.10 版本之前，OpenClaw 的 /model 指令存在一個已知 Bug（GitHub Issue #646）。用戶輸入 /model opus 或 /model gpt 後，系統回覆「模型已切換」，但 AI 的實際回答卻沒有任何改變，仍然使用原本的模型。
如何確認你遇到的是這個 Bug？
用以下測試步驟確認你是否遇到了這個 /model 切換失效的 Bug：
# 測試步驟一：查看目前模型
/model status
# 輸出：Current model: claude-haiku-3.5
# 測試步驟二：嘗試切換
/model opus
# 輸出：Switched to claude-opus-4 ✓（看起來成功了！）
# 測試步驟三：再次查看狀態
/model status
# 輸出：Current model: claude-haiku-3.5 ← 沒有改變！
# 測試步驟四：詢問 AI 它是哪個模型
你好，你是哪個 Claude 版本？
# 輸出：「我是 Claude Haiku...」← 仍然是舊模型！
✅ 確認是這個 Bug 的判斷條件
- •
/model回應「切換成功」但實際模型未改變 - •
/model status顯示的仍是切換前的模型 - • AI 回答的風格和能力沒有明顯變化
- • OpenClaw 版本低於 2026.1.10
Bug 的根本原因：Session Key 錯誤
這個 Bug 的技術根因很有意思，值得深入了解，這樣你以後碰到類似問題也能更快診斷：
📐 技術原因解析
舊版（Bug版）的行為
當用戶在 Telegram 輸入 /model opus 時，這個斜線指令是在一個特殊的 session（telegram:slash:xxx）下執行的。然而，模型切換設定被寫入的是這個臨時 slash session，而不是你的實際對話 session（telegram:chat:xxx）。
後果
臨時 slash session 完成後就被丟棄，你的實際對話 session 從未被修改過。所以下一條訊息的 AI 回應，仍然來自原本的模型。
修復版（2026.1.10）的行為
修復後的版本使用 ctx.CommandTargetSessionKey，確保 /model 指令直接修改的是你的實際對話 session，而不是臨時的 slash session。從此，/model 切換後立即生效。
解決方案：三種修復方法
最佳方法：更新到 2026.1.10 或更新版本
這個 Bug 在 2026.1.10 版已正式修復。最直接的解決方式就是更新 OpenClaw：
# 查看目前版本
openclaw --version
# 更新到最新版
openclaw update
# 更新完後確認版本
openclaw --version
# 應該顯示 2026.1.10 或更高版本
# 重啟 gateway
openclaw gateway restart
替代方法：用 CLI 切換模型（不依賴 /model 指令）
如果暫時無法更新，可以直接在終端機用 CLI 切換模型，繞過有 Bug 的 slash command 系統：
# 用 CLI 直接設定預設模型（立即生效）
openclaw config set model.default claude-opus-4
# 或切換到 GPT
openclaw config set model.default gpt-5.4
# 重新載入設定（不需要完整重啟）
openclaw gateway reload
# 確認生效
openclaw config get model.default
進階方法：設定快捷別名腳本
為常用的模型切換操作設定 shell 別名，讓切換更方便：
# 在 ~/.bashrc 或 ~/.zshrc 加入
alias claw-opus='openclaw config set model.default claude-opus-4 && openclaw gateway reload'
alias claw-sonnet='openclaw config set model.default claude-sonnet-4 && openclaw gateway reload'
alias claw-gpt='openclaw config set model.default gpt-5.4 && openclaw gateway reload'
alias claw-codex='openclaw config set model.default codex && openclaw gateway reload'
# 套用設定
source ~/.zshrc
# 之後只需要一個指令就能切換
claw-opus # 切換到 Claude Opus
claw-gpt # 切換到 GPT-5.4
相關：Skill 靜默失敗的 Bug（Issue #22436）
除了 /model 的問題，OpenClaw 還有另一個相關 Bug（Issue #22436）：當 Auth Profile 損壞時，/skill 指令會靜默失敗，沒有任何錯誤訊息，只是什麼都不發生。
症狀
# 用戶輸入
/skill gmail 顯示今天的未讀郵件
# 預期回應：Gmail 的未讀郵件列表
# 實際回應：(空白，什麼都沒有)
# 用戶再試一次
/skill gmail
# 實際回應：(還是空白)
排查與修復方法
# 步驟一：確認 Skill 已安裝
openclaw skill list
# 步驟二：確認 Auth 狀態正常
openclaw auth check --verbose
# 步驟三：重新授權損壞的 Auth Profile
openclaw auth repair
# 步驟四：重新安裝有問題的 Skill
openclaw skill reinstall gmail
# 步驟五：測試
openclaw skill test gmail
/model 指令修復版本歷史
| 版本 | /model 行為 | 建議 |
|---|---|---|
| < 2026.1.10 | 看似成功但實際未切換（Bug） | 立即更新 |
| 2026.1.10 | Bug 修復，/model 正常切換 | 可用 |
| 2026.2.x | 新增 /model status 詳細資訊 | 推薦 |
| 最新版 | 支援熱切換，不需重啟 gateway | 最佳 |
更新後 /model 還是沒反應？
如果你已經確認版本在 2026.1.10 以上，但 /model 仍然沒有切換效果，可能是以下原因：
🔄 Gateway 快取未清除
更新後如果沒有重啟 gateway，舊的設定可能仍然在記憶體中。
openclaw gateway restart --force
🔒 目標模型 Token 未設定
如果你嘗試切換到 GPT 但沒有設定 OpenAI API Key，切換指令會回滾到原來的模型。
openclaw auth status --verbose # 查看哪些模型有有效 Token
📡 通訊平台的指令處理差異
Telegram、Discord、WhatsApp 等不同平台的斜線指令處理機制略有不同。如果在某個平台的 /model 沒效果，嘗試改用 CLI 直接切換，確認是否是特定平台的問題。
這個 Bug 在 X.com 上的討論
這個 /model Bug 在 OpenClaw 用戶社群中引發了廣泛討論。許多用戶在 X.com 上分享了他們的困惑：「為什麼切換了模型，但 AI 的回答速度和品質感覺沒有變化？」這個問題困擾了很多用戶，直到有人在 GitHub 上提交 Issue #646 才被官方正式確認。
"Tried to switch to opus for a complex task but it still felt like haiku. Turns out /model was broken all along."
— GitHub Issue #646 留言"The fix was simple but impactful - route state through ctx.CommandTargetSessionKey. Lessons: always verify command context in multi-session environments."
— OpenClaw 開發者 Commit b99eb4c9f 說明模型切換的最佳實踐（2026年）
✅ 建議做法
- • 保持 OpenClaw 更新到最新版
- • 切換後用
/model status確認 - • 詢問 AI「你是哪個模型？」做雙重確認
- • 為常用切換操作設定 shell 別名
❌ 避免的做法
- • 不確認就認為切換成功
- • 在舊版本下依賴 /model 切換
- • 切換模型時中途強制中斷 terminal
- • 同時在多個 session 中切換模型
如何向 OpenClaw 回報新的指令 Bug？
如果你在最新版本中仍然發現指令行為異常，建議通過官方 GitHub 回報 Bug，這樣開發者才能快速修復。以下是有效回報的格式：
# Bug 回報必要資訊
## 環境資訊
openclaw --version # 版本號
openclaw gateway version # gateway 版本
uname -a # 作業系統
通訊平台：Telegram / Discord / CLI 直接操作
## 重現步驟
1. 執行 /model status（記錄當前模型）
2. 執行 /model [目標模型]
3. 等待 3 秒後執行 /model status
4. 傳送「你是哪個版本的 AI？」確認實際模型
## 期望行為
/model status 應顯示新模型，AI 回應風格應改變
## 實際行為
（描述你看到的）
## 日誌
openclaw gateway log --last=100 2>&1 | tail -50
💡 回報 Bug 的好習慣
- • 先搜尋 GitHub Issue 確認是否有重複回報
- • 提供完整的重現步驟（讓開發者能在本地重現）
- • 附上相關日誌（但記得遮蔽 API Key！）
- • 描述你的使用環境（OS、通訊平台、VPN 狀態）
OpenClaw 用戶常用的除錯社群資源
🐙 GitHub Issues
所有已知 Bug 和修復記錄都在這裡。搜尋 label:bug slash-command 或 /model 可以找到相關問題。
🐦 X.com #openclaw
X.com 上的 OpenClaw 社群非常活躍，許多用戶在這裡分享第一手的問題和解決方案，速度比 GitHub 更快。
💬 Discord 官方伺服器
OpenClaw 官方 Discord 有專門的 #bug-reports 和 #help 頻道，開發者本人有時也會直接回覆。
📖 官方文件
docs.openclaw.ai 有完整的斜線指令說明，每個指令的參數、預設值和已知限制都有詳細文件。
網路問題也可能讓 /model 看起來無效
即使 Bug 已修復，如果你的網路連線不穩定，/model 切換後的第一個 API 請求可能因為逾時而失敗，OpenClaw 可能會自動回退到上一個可用的模型，看起來像是切換無效。確保使用穩定的網路連線是避免這種誤解的關鍵。
💡 為什麼 /model 切換後的第一個請求特別重要？
切換模型後，OpenClaw gateway 需要向新的 API 端點（如從 Anthropic 切換到 OpenAI）建立新的連線。這個連線建立過程需要 1-3 秒的額外時間，且對網路穩定性要求更高。如果這時網路波動，連線可能失敗並觸發回退機制。
VPN07 - 讓模型切換零失敗
1000Mbps千兆頻寬 · 模型切換第一個請求零逾時 · 穩定運營十年
解決了 /model Bug 之後，確保網路穩定才是讓 OpenClaw 模型切換真正可靠的最後一塊拼圖。VPN07 提供 1000Mbps 千兆頻寬，讓每次模型切換後的首個 API 請求能在毫秒內完成建立，不因網路逾時觸發回退機制。十年老品牌，70+ 國家節點，月費僅 $1.5 美元，30 天無條件退款保障。