一、版本概覽

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

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

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

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

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

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

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

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

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

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

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

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

• ? 為OpenAI與OpenAI Codex模型默認(rèn)啟用apply_patch功能。

• ? 對(duì)齊apply_patch的沙箱策略訪問權(quán)限與寫入權(quán)限，保障操作安全性。

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

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

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

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

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

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

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

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

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

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

• ? 卸載頻道插件時(shí)，自動(dòng)移除對(duì)應(yīng)的channels. 配置項(xiàng)。

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

• ? 為Discord、BlueBubbles、iMessage新增當(dāng)前對(duì)話ACP綁定功能。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• ? 回復(fù)格式：剝離內(nèi)聯(lián)回復(fù)標(biāo)簽時(shí)保留前導(dǎo)縮進(jìn)，純文本與代碼塊格式不受影響。

• ? 子代理通知：恢復(fù)BlueBubbles等擴(kuò)展頻道的完成通知投遞。

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

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

• ? 工具調(diào)用復(fù)用：構(gòu)建HTTP/tools/invoke工具列表時(shí)復(fù)用會(huì)話工作區(qū)，默認(rèn)推斷會(huì)話代理工作區(qū)，避免工作區(qū)插件重復(fù)注冊(cè)。

• ? 錯(cuò)誤分類：將HTTP 410錯(cuò)誤默認(rèn)歸類為可重試超時(shí)，同時(shí)保留會(huì)話過期、計(jì)費(fèi)、認(rèn)證等顯式信號(hào)。

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

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

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

• ? 移除常規(guī)運(yùn)行時(shí)對(duì)舊版tts. API-key 格式的降級(jí)支持。

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

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

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

• ? 陳舊使用預(yù)飛行壓縮時(shí)保留壓縮后AGENTS刷新，保障Discord兼容上游beta構(gòu)造器變更。

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

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

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