一、版本概覽

openclaw于2026年3月29日正式發(fā)布v2026.3.28最新版本，本次更新包含多項Breaking變更與功能優(yōu)化，覆蓋模型提供商適配、配置管理、插件系統(tǒng)、多平臺交互、容器部署、CLI工具等多個核心模塊，全面提升AI智能體框架的穩(wěn)定性、安全性與易用性，以下為完整更新內(nèi)容詳解。

二、Breaking變更（不兼容更新） 1. Qwen提供商認證遷移

• ? 移除已棄用的qwen-portal-authOAuth集成（適配portal.qwen.ai），該認證方式不再可用。

• ? 遷移方案：切換至Model Studio認證，使用命令openclaw onboard --auth-choice modelstudio-api-key完成配置。

• ? 自動配置遷移功能僅保留近兩個月內(nèi)的配置項，超過兩個月的舊版配置不再自動遷移。

• ? 極舊的遺留配置密鑰加載時不再自動重寫，而是直接觸發(fā)驗證失敗，需手動更新配置。

• ? 捆綁的xAI提供商遷移至Responses API，新增原生x_search搜索能力。

• ? 自動啟用xAI插件，無需手動切換，基于已有的網(wǎng)頁搜索與工具配置，即可直接使用Grok認證與搜索流程。

• ? 新增Grok網(wǎng)頁搜索插件引導：在openclaw onboard和openclaw configure --section web流程中，提供可選的x_search設置，包含共享xAI密鑰的模型選擇器。

• ? 新增MiniMax圖像生成提供商，支持image-01模型。

• ? 核心能力：支持圖像生成、圖像到圖像編輯，可自定義圖像寬高比。

• ? 模型目錄精簡：僅保留M2.7模型，移除M2、M2.1、M2.5、VL-01等舊版模型。

• ? 為OpenAI與OpenAI Codex模型默認啟用apply_patch功能。

• ? 對齊apply_patch的沙箱策略訪問權限與寫入權限，保障操作安全性。

• ? 插件鉤子新增async requireApproval（before_tool_call鉤子），可暫停工具執(zhí)行，向用戶發(fā)起審批請求。

• ? 審批渠道：支持執(zhí)行審批覆蓋層、Telegram按鈕、Discord交互、任意頻道/approve命令。

• ? 命令統(tǒng)一：/approve命令同時處理執(zhí)行與插件審批，自動降級適配不同場景。

• ? 捆綁的Claude CLI、Codex CLI、Gemini CLI推理默認配置遷移至插件層面，新增Gemini CLI后端支持。

• ? 命令替換：gateway run --claude-cli-logs替換為通用--cli-backend-logs，保留舊命令作為兼容別名。

• ? 自動加載：從顯式配置引用中自動加載捆綁的提供商與CLI后端插件，無需手動配置plugins.allow條目。

• ? 插件運行時系統(tǒng)命名空間暴露runHeartbeatOnce，支持觸發(fā)單次心跳周期，可指定消息投遞目標（如heartbeat: { target: "last" }）。

• ? 內(nèi)存管理：預壓縮內(nèi)存刷新計劃遷移至活躍內(nèi)存插件合約，由內(nèi)存核心模塊控制刷新提示與目標路徑策略，替代硬編碼邏輯。

• ? 依賴保障：打包更新時預加載捆綁的@pierre/diffs運行時依賴，確保全局安裝與更新后差異查看器正常加載。

• ? 主題兼容：加載捆綁的Pierre主題時移除JSON模塊導入，適配新版Node.js構建環(huán)境。

• ? 卸載頻道插件時，自動移除對應的channels. 配置項。

• ? 卸載預覽與顯式頻道所有權規(guī)則對齊，內(nèi)置頻道與共享密鑰不受影響。

• ? 為Discord、BlueBubbles、iMessage新增當前對話ACP綁定功能。

• ? 命令支持：/acp spawn codex --bind here可將當前聊天直接轉為Codex工作區(qū)，無需創(chuàng)建子線程。

• ? 文檔完善：明確區(qū)分聊天界面、ACP會話、運行時工作區(qū)的概念差異。

• ? 新增顯式upload-fileSlack操作，通過現(xiàn)有Slack上傳通道處理文件上傳。

• ? 支持自定義：可覆蓋頻道與私信的文件名、標題、備注信息。

• ? 基于upload-file操作統(tǒng)一文件優(yōu)先發(fā)送邏輯，新增Microsoft Teams、Google Chat顯式支持。

• ? BlueBubbles文件發(fā)送通過upload-file實現(xiàn)，保留sendAttachment舊別名兼容。

• ? TTS回復：自動TTS回復以原生Matrix語音氣泡形式發(fā)送，替代通用音頻附件。

• ? 媒體處理：保留入站媒體的發(fā)送者文件名，將originalFilename轉發(fā)至saveMediaBuffer。

• ? 提及識別：支持識別matrix.to提及（可見標簽為機器人房間顯示名），requireMention: true的房間可在新版Matrix客戶端正常響應。

• ? DM路由：選擇外發(fā)直接房間時優(yōu)先顯式DM信號，避免嚴格雙人回退房間覆蓋真實DM。

• ? 認證配置：啟動時解析環(huán)境變量-backed的accessToken與passwordSecretRefs，正式支持SecretRef格式的accessToken配置。

• ? 加密優(yōu)化：E2EE加密圖像縮略圖使用thumbnail_file，未加密房間保留thumbnail_url預覽，兼顧安全性與可用性。

• ? 依賴加載：通過createRequire(...)加載捆綁的@matrix-org/matrix-sdk-crypto-nodejs，保障打包ESM構建中E2EE媒體收發(fā)的原生綁定正常工作。

• ? 發(fā)送用戶消息時，優(yōu)先選擇最新的個人會話引用，避免回復指向陳舊DM線程。

• ? 保留論壇線程命令上下文的話題目標，/new、/reset命令始終路由至活躍話題。

• ? 回復格式：剝離內(nèi)聯(lián)回復標簽時保留前導縮進，純文本與代碼塊格式不受影響。

• ? 子代理通知：恢復BlueBubbles等擴展頻道的完成通知投遞。

• ? 簡化當前無root用戶的容器設置，將啟動助手安裝至~/.local/bin目錄。

• ? 工作流優(yōu)化：推薦使用openclaw --container ... 主機CLI命令，替代專用openclaw服務用戶。

• ? 工具調(diào)用復用：構建HTTP/tools/invoke工具列表時復用會話工作區(qū)，默認推斷會話代理工作區(qū)，避免工作區(qū)插件重復注冊。

• ? 錯誤分類：將HTTP 410錯誤默認歸類為可重試超時，同時保留會話過期、計費、認證等顯式信號。

• ? 狀態(tài)展示：openclaw daemon status優(yōu)先展示輕量級探測的網(wǎng)關關閉原因， concrete認證/配對失敗信息替代通用超時提示。

• ? 新增openclaw config schema命令，可打印openclaw.json的生成JSON Schema，便于配置校驗與開發(fā)。

• ? 常規(guī)讀取與密鑰解析時自動遷移舊版語音配置，保留Doctor診斷功能。

• ? 移除常規(guī)運行時對舊版tts. API-key 格式的降級支持。

• ?thinkingLevel=off通過Ollama擴展請求路徑傳遞，支持思考能力的Ollama模型接收think: false參數(shù)，避免靜默生成隱藏推理Token。

• ? 請求與緩存鍵生成前，將不支持的Brave國家過濾器歸一化為ALL，避免VN等地區(qū)值觸發(fā)上游422驗證錯誤。

• ?inbound_claim鉤子元數(shù)據(jù)傳遞完整入站附件數(shù)組，保留舊版單一媒體附件字段以兼容舊插件。

• ? 陳舊使用預飛行壓縮時保留壓縮后AGENTS刷新，保障Discord兼容上游beta構造器變更。

代碼地址：bgithub.xyz/openclaw/openclaw

openclaw v2026.3.28版本聚焦模型適配、插件安全、多平臺交互、部署簡化四大核心方向，通過Breaking變更清理歷史包袱，同時新增多項實用功能，大幅提升AI智能體開發(fā)與運行的效率與安全性。開發(fā)者需重點關注Qwen認證遷移、配置遷移規(guī)則調(diào)整，按需升級模型與插件配置，充分利用xAI搜索、MiniMax圖像生成、工具審批等新特性，構建更強大、更安全的AI應用。

我們相信人工智能為普通人提供了一種“增強工具”，并致力于分享全方位的AI知識。在這里，您可以找到最新的AI科普文章、工具評測、提升效率的秘籍以及行業(yè)洞察。 歡迎關注“福大大架構師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來發(fā)展。