3.22 把龍蝦開膛破肚，換了引擎。3.23 盯著縫合線，確認沒崩。3.24 開始復健——跑得比手術前還快。
3.28：龍蝦長出了新殼。
不是蛻皮後那層軟趴趴的半透明膜。是真正的甲殼。緻密、層疊、經得起實戰。配套的新鉗子也到位了。
兩項 Breaking Changes。二十一項新功能。九十多個修復。老規矩：生產環境的龍蝦，升級前三思。
Breaking Changes
兩項。都是乾淨俐落的切割。
通義千問 Portal OAuth 下線了。 廢棄的 \qwen-portal-auth\ 整合（用於 portal.qwen.ai）已移除。遷移到 Model Studio：\openclaw onboard --auth-choice modelstudio-api-key\。(#52709) 感謝 @pomelo-nwu。
設定自動遷移有保質期了。 \openclaw doctor\ 不再自動重寫兩個月以前的舊設定鍵。跑著上古設定的使用者，現在會直接觸發驗證失敗，而不是被靜默重寫。該更新就更新吧。
新鉗子：模型與提供商
MiniMax 圖像生成
MiniMax 作為圖像生成提供商加入，帶來 \image-01\ 模型。文字生圖。圖片編輯（image-to-image）。寬高比控制。(#54487) 感謝 @liyuan97。
這是 OpenClaw 的第一個專用圖像生成提供商。你的龍蝦現在不只能看——還能畫。
順帶一提，MiniMax 的模型目錄也精簡了：只留 M2.7，砍掉了 M2、M2.1、M2.5 和 VL-01。輕裝上陣。
xAI 全面切換 Responses API
內建的 xAI 提供商遷移到 Responses API，\x_search\ 成為一等公民。xAI 外掛現在根據 web-search 和工具設定自動啟用——不用再手動開關了。(#56048) 感謝 @huntharo。
\openclaw onboard\ 和 \openclaw configure --section web\ 現在會在引導流程中提供可選的 x_search 設定，包括一個共享 xAI key 的模型選擇器。
CLI 後端擴展
Claude CLI、Codex CLI、Gemini CLI 的推理預設設定全部遷移到外掛表面。Gemini CLI 獲得內建後端支援。\--cli-backend-logs\ 替代了 \--claude-cli-logs\（舊 flag 保留為別名）。自動載入意味著設定好的內建頻道不再需要手動新增 \plugins.allow\ 條目。
新反射弧：非同步工具審批
這是給外掛開發者的頭號功能。
\before_tool_call\ 鉤子現在支援非同步 \requireApproval\——外掛可以在工具執行到一半時按下暫停鍵，彈出審批請求。審批介面靈活可選：exec 審批彈層、Telegram 按鈕、Discord 互動元件，或者在任何頻道上用 \/approve\ 指令。(#55339) 感謝 @vaclavbelak 和 @joshavant。
\/approve\ 指令現在同時處理 exec 審批和外掛審批，自動回退。一條指令，兩條審批路徑。
說白了：外掛可以盯著危險操作——刪檔案、刪資料庫、往正式環境推程式碼——在執行前攔住，等人點頭再放行。你的 AI 助手裝上了安全聯鎖裝置。賽博祕書穿好了防彈衣。
新甲殼：安全加固
Web search 金鑰稽核擴展。 安全稽核現在能識別 Gemini、Grok/xAI、Kimi、Moonshot 和 OpenRouter 的憑證，透過邊界安全的內建 web-search 註冊表墊片實現。(#56540)
ACP agent 註冊表加固。 OpenClaw 的 ACPX 內建 agent 鏡像與最新的 \openclaw/acpx\ 指令預設值和內建別名對齊，版本化的 npx 內建工具鎖定到精確版本，未知 ACP agent ID 不再穿透到 MCP-proxy 路徑上的原始 \--agent\ 指令執行。(#28321) 感謝 @m0nkmaster 和 @vincentkoc。
OpenAI apply_patch 預設啟用，適用於 OpenAI 和 Codex 模型，沙箱策略與寫入權限對齊。
頻道升級
ACP 當前對話綁定。 \/acp spawn codex --bind here\ 現在可以把當前的 Discord、BlueBubbles 或 iMessage 聊天直接變成 Codex 工作區，不用另開子討論串。
Slack 檔案上傳。 新增顯式 upload-file 動作，透過 Slack 的上傳通道路由檔案，支援檔名、標題、備註的自訂覆蓋。
統一檔案發送。 Microsoft Teams、Google Chat、BlueBubbles 獲得顯式 \upload-file\ 支援，開始統一跨頻道的檔案優先發送體驗。
Matrix 原生語音氣泡。 Matrix 上的自動 TTS 回覆現在以原生語音氣泡形式發送，不再是通用音訊附件。(#37080) 感謝 @Matthew19990919。
基礎設施
Podman 簡化。 容器設定圍繞當前 rootless 使用者整合。啟動輔助腳本安裝到 \~/.local/bin\。工作流變成從宿主機直接 \openclaw --container <name> ...\。
\openclaw config schema\ 印出 \openclaw.json\ 的生成 JSON Schema。(#54523) 感謝 @kvokka。
記憶體外掛契約。 壓縮前的記憶體刷寫計畫移到活躍記憶體外掛契約後面——\memory-core\ 擁有刷寫提示和目標路徑策略，不再是寫死的核心邏輯。
外掛心跳。 \runHeartbeatOnce\ 暴露在外掛執行時系統命名空間中，支援單次心跳循環和投遞目標覆蓋。(#40299) 感謝 @loveyana。
Tavily 流量歸因。 出站 API 請求現在攜帶 \X-Client-Source: openclaw\，讓 Tavily 能識別來自 OpenClaw 的流量。(#55335) 感謝 @lakshyaag-tavily。
修復精選
從 90 多個修復中挑幾個：
Agents/Anthropic：未處理的提供商停止原因（如 \sensitive\）現在作為結構化助手錯誤恢復，不再導致 agent 執行崩潰。(#56639)
Google/Gemini 3.1：pro、flash、flash-lite 在所有 Google 提供商別名下正確解析。flash-lite 前綴排序修復。(#56567)
WhatsApp 回聲迴圈：自聊天 DM 模式下，bot 不再把自己發出去的回覆當成新訊息重新處理，死迴圈終結。(#54570) 感謝 @joelnishanth。
Telegram 訊息切分：長訊息現在按單詞邊界切分，不再切在詞中間。標籤開銷超限時優雅降級。(#56595)
Discord 重連：過期的 gateway socket 被排空，強制重連前清除快取的 resume 狀態。恢復流程不再在中毒的 resume 狀態上死迴圈。(#54697) 感謝 @ngutman。
Agents/冷卻：速率限制冷卻現在按模型隔離——一個模型的 429 不再阻塞同 auth 設定下的所有模型。階梯式 30s/1min/5min 替代了舊的指數升級。(#49834) 感謝 @kiranvk-2011。
Matrix E2EE 縮圖：加密房間的圖片事件現在用 \thumbnail_file\ 加密縮圖，非加密房間繼續用 \thumbnail_url\ 明文預覽。(#54711) 感謝 @frischeDaten。
GitHub Copilot 認證：過大的 \expires_at\ 值被當作秒級時間戳處理，遠未來的刷新計時器被箝位，防止 setTimeout 溢位熱迴圈。(#55360) 感謝 @michael-abdo。
Mistral：OpenAI 相容請求旗標規範化，官方 Mistral API 不再報 \422 status code (no body)\ 錯誤。
iMessage：內嵌的 \[[reply_to:...]]\ 標籤不再洩漏到投遞文字中——\reply_to\ 作為 RPC 中繼資料發送。(#39512) 感謝 @mvanhorn。
貢獻者
這個版本包含 50 多位貢獻者的工作。
@huntharo 交付了 xAI Responses API 遷移、Telegram 配對修復和外掛入站 claims——承包了本版本最大的功能遷移之一。
@ngutman 落地了 Discord 重連恢復、兩輪沙箱改進和 Carbon beta 更新——系統性的縱深防禦。
@neeravmakwana 修復了 OpenAI Codex 圖像工具、agents/status 上下文視窗、gateway 外掛複用和 CLI 外掛自動載入——四個修復跨四個子系統。
@joelnishanth 搞定了 WhatsApp 回聲迴圈、兩個 Discord gateway 關閉邊界情況和 Matrix E2EE 加密載入——安靜、紮實的頻道加固。
@xaeon2026 修復了 OpenAI 相容 tool call 去重、WebSocket 推理回放、agents/status 和 Codex 回退——深層 agent 基礎設施工作。
@shakkernerd 發布了三項 TUI 改進：引導流程 gateway 訊息、聊天日誌系統訊息裁剪、activation 參數校驗。
感謝 @pomelo-nwu、@liyuan97、@vaclavbelak、@joshavant、@kvokka、@velvet-shark、@lakshyaag-tavily、@Matthew19990919、@loveyana、@gumadeiras、@schumilin、@scoootscooob、@BruceMacD、@gumclaw、@vincentkoc、@m0nkmaster、@mvanhorn、@kiranvk-2011、@michael-abdo、@frischeDaten、@bugkill3r、@erhhung、@sahancava、@danhdoan、@dongzhenye、@gregretkowski、@afurm、@jared596、@wbxl2000、@xieyongliang、@adzendo、@frankbuild、@alberthild、@nikus-pan、@felear2022、@markojak、@infichen、@bottenbenny、@mcaxtr、@MiloStack、@SnowSky1、@lurebat、@private-peter、@sallyom、@MonkeyLeeT、@oliviareid-svg、@chen-zhang-cs-code、@Nanako0129、@mbelinky、@nickludlam、@kakahu2015、@mathiasnagler、@NickHood1984、@esrehmki、@aquaright1、@xujingchen1996、@lml2468、@sparkyrider、@KevInTheCloud5617、@cosmicnet、@hongsw、@Takhoffman、@ysfbsf、@glitch418x、@Kimbo7870、@w-sss，以及所有提交過 Issue、測試過預發布版本、在 Discord 裡幫過忙的人。
---
3.22 把龍蝦拆開。3.23 把牠縫活。3.24 讓牠跑起來。
3.28：新殼長成。新鉗子用來造圖。新反射弧用來攔截危險。新甲殼，由九十多個修復和五十多位貢獻者的工作鍛造而成。
龍蝦披甲完畢。出擊。
