北京
一、版本概覽
openclaw于2026年3月29日正式發布v2026.3.28最新版本，本次更新包含多項Breaking變更與功能優化，覆蓋模型提供商適配、配置管理、插件系統、多平臺交互、容器部署、CLI工具等多個核心模塊，全面提升AI智能體框架的穩定性、安全性與易用性，以下為完整更新內容詳解。
二、Breaking變更（不兼容更新） 1. Qwen提供商認證遷移
? 移除已棄用的
qwen-portal-authOAuth集成（適配portal.qwen.ai），該認證方式不再可用。? 遷移方案：切換至Model Studio認證，使用命令
openclaw onboard --auth-choice modelstudio-api-key完成配置。
? 自動配置遷移功能僅保留近兩個月內的配置項，超過兩個月的舊版配置不再自動遷移。
? 極舊的遺留配置密鑰加載時不再自動重寫，而是直接觸發驗證失敗，需手動更新配置。
? 捆綁的xAI提供商遷移至Responses API，新增原生
x_search搜索能力。? 自動啟用xAI插件，無需手動切換，基于已有的網頁搜索與工具配置，即可直接使用Grok認證與搜索流程。
? 新增Grok網頁搜索插件引導：在
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鉤子），可暫停工具執行，向用戶發起審批請求。? 審批渠道：支持執行審批覆蓋層、Telegram按鈕、Discord交互、任意頻道
/approve命令。? 命令統一：
/approve命令同時處理執行與插件審批，自動降級適配不同場景。
? 捆綁的Claude CLI、Codex CLI、Gemini CLI推理默認配置遷移至插件層面，新增Gemini CLI后端支持。
? 命令替換：
gateway run --claude-cli-logs替換為通用--cli-backend-logs，保留舊命令作為兼容別名。? 自動加載：從顯式配置引用中自動加載捆綁的提供商與CLI后端插件，無需手動配置
plugins.allow條目。
? 插件運行時系統命名空間暴露
runHeartbeatOnce，支持觸發單次心跳周期，可指定消息投遞目標（如heartbeat: { target: "last" }）。? 內存管理：預壓縮內存刷新計劃遷移至活躍內存插件合約，由內存核心模塊控制刷新提示與目標路徑策略，替代硬編碼邏輯。
? 依賴保障：打包更新時預加載捆綁的
@pierre/diffs運行時依賴，確保全局安裝與更新后差異查看器正常加載。? 主題兼容：加載捆綁的Pierre主題時移除JSON模塊導入，適配新版Node.js構建環境。
? 卸載頻道插件時，自動移除對應的
channels.配置項。? 卸載預覽與顯式頻道所有權規則對齊，內置頻道與共享密鑰不受影響。
? 為Discord、BlueBubbles、iMessage新增當前對話ACP綁定功能。
? 命令支持：
/acp spawn codex --bind here可將當前聊天直接轉為Codex工作區，無需創建子線程。? 文檔完善：明確區分聊天界面、ACP會話、運行時工作區的概念差異。
? 新增顯式
upload-fileSlack操作，通過現有Slack上傳通道處理文件上傳。? 支持自定義：可覆蓋頻道與私信的文件名、標題、備注信息。
? 基于
upload-file操作統一文件優先發送邏輯，新增Microsoft Teams、Google Chat顯式支持。? BlueBubbles文件發送通過
upload-file實現，保留sendAttachment舊別名兼容。
? TTS回復：自動TTS回復以原生Matrix語音氣泡形式發送，替代通用音頻附件。
? 媒體處理：保留入站媒體的發送者文件名，將
originalFilename轉發至saveMediaBuffer。? 提及識別：支持識別
matrix.to提及（可見標簽為機器人房間顯示名），requireMention: true的房間可在新版Matrix客戶端正常響應。? DM路由：選擇外發直接房間時優先顯式DM信號，避免嚴格雙人回退房間覆蓋真實DM。
? 認證配置：啟動時解析環境變量-backed的
accessToken與passwordSecretRefs，正式支持SecretRef格式的accessToken配置。? 加密優化：E2EE加密圖像縮略圖使用
thumbnail_file，未加密房間保留thumbnail_url預覽，兼顧安全性與可用性。? 依賴加載：通過
createRequire(...)加載捆綁的@matrix-org/matrix-sdk-crypto-nodejs，保障打包ESM構建中E2EE媒體收發的原生綁定正常工作。
? 發送用戶消息時，優先選擇最新的個人會話引用，避免回復指向陳舊DM線程。
? 保留論壇線程命令上下文的話題目標，
/new、/reset命令始終路由至活躍話題。
? 回復格式：剝離內聯回復標簽時保留前導縮進，純文本與代碼塊格式不受影響。
? 子代理通知：恢復BlueBubbles等擴展頻道的完成通知投遞。
? 簡化當前無root用戶的容器設置，將啟動助手安裝至
~/.local/bin目錄。? 工作流優化：推薦使用
openclaw --container ...主機CLI命令，替代專用openclaw服務用戶。
? 工具調用復用：構建HTTP
/tools/invoke工具列表時復用會話工作區，默認推斷會話代理工作區，避免工作區插件重復注冊。? 錯誤分類：將HTTP 410錯誤默認歸類為可重試超時，同時保留會話過期、計費、認證等顯式信號。
? 狀態展示：
openclaw daemon status優先展示輕量級探測的網關關閉原因， concrete認證/配對失敗信息替代通用超時提示。
? 新增
openclaw config schema命令，可打印openclaw.json的生成JSON Schema，便于配置校驗與開發。
? 常規讀取與密鑰解析時自動遷移舊版語音配置，保留Doctor診斷功能。
? 移除常規運行時對舊版
tts. API-key格式的降級支持。
?
thinkingLevel=off通過Ollama擴展請求路徑傳遞，支持思考能力的Ollama模型接收think: false參數，避免靜默生成隱藏推理Token。
? 請求與緩存鍵生成前，將不支持的Brave國家過濾器歸一化為
ALL，避免VN等地區值觸發上游422驗證錯誤。
?
inbound_claim鉤子元數據傳遞完整入站附件數組，保留舊版單一媒體附件字段以兼容舊插件。
? 陳舊使用預飛行壓縮時保留壓縮后AGENTS刷新，保障Discord兼容上游beta構造器變更。
代碼地址：bgithub.xyz/openclaw/openclaw
openclaw v2026.3.28版本聚焦模型適配、插件安全、多平臺交互、部署簡化四大核心方向，通過Breaking變更清理歷史包袱，同時新增多項實用功能，大幅提升AI智能體開發與運行的效率與安全性。開發者需重點關注Qwen認證遷移、配置遷移規則調整，按需升級模型與插件配置，充分利用xAI搜索、MiniMax圖像生成、工具審批等新特性，構建更強大、更安全的AI應用。
我們相信人工智能為普通人提供了一種“增強工具”，并致力于分享全方位的AI知識。在這里，您可以找到最新的AI科普文章、工具評測、提升效率的秘籍以及行業洞察。 歡迎關注“福大大架構師每日一題”，發消息可獲得面試資料，讓AI助力您的未來發展。
特別聲明：以上內容(如有圖片或視頻亦包括在內)為自媒體平臺“網易號”用戶上傳并發布，本平臺僅提供信息存儲服務。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
