OpenClaw 3.28上線！4天爆更上百項重要更新

新智元報道

編輯：艾倫

【新智元導(dǎo)讀】OpenClaw 3.28 大更新：不僅內(nèi)置 Grok 搜索、支持 MiniMax 畫圖，更上線了最保命的「高危操作彈窗攔截」功能。

前兩天，大家都見識到了 OpenClaw 之父 Peter 的極限「草臺」操作。

漏打包 UI 資源文件，直接導(dǎo)致海量小龍蝦在 3.22 版本集體白屏。

拓展閱讀：OpenClaw 3.23緊急修復(fù)！Peter忘記打包控制臺文件，海量龍蝦崩潰

當(dāng)時很多朋友連控制臺都進(jìn)不去，還以為自己辛辛苦苦養(yǎng)的蝦死透了。

雖然后來 3.23 緊急上了修補(bǔ)丁，還順手給發(fā)布流程加了自動攔截的保險，但這事兒弄得大家心里一陣發(fā)毛。

因為現(xiàn)在的 Agent，權(quán)限實在太大了——一點(diǎn)點(diǎn)代碼上的疏漏，都可能是一場災(zāi)難。

今天，OpenClaw 直接推送了最新的 3.28 版本。

這次更新的內(nèi)容也是格外豐富，簡直是底層能力的全面大解放。

簡單挑幾個跟日常體驗關(guān)系最大的。

Qwen 模型正式遷移到了 Model Studio，直接走新的認(rèn)證選項，干凈利落。

xAI 被提到了第一梯隊，原生的 Grok 網(wǎng)頁搜索和工具配置直接內(nèi)置了，不用再像以前那樣手動來回折騰開關(guān)。

畫圖黨也有福了，MiniMax 加了進(jìn)來，完美支持 image-01 模型的圖像生成和長寬比編輯。

最夸張的，是插件系統(tǒng)加入了一個叫requireApproval的異步攔截功能。

你的小龍蝦在執(zhí)行那些高危操作前，終于可以暫停下來，通過 Telegram、Discord 或者命令行直接彈個框，問你一句：「老板，這活兒能干嗎？」

現(xiàn)在的 Agent 能畫圖、能搜網(wǎng)、能隨意切模型，甚至能把當(dāng)前的聊天頻道直接變成專屬的工作區(qū)。

但，能力越強(qiáng)，水越深。

要是這些逆天的能力和底層權(quán)限，交到一個來路不明的惡意 Skills 手里，畫面簡直不敢看。

這也是為什么前一陣國家互聯(lián)網(wǎng)應(yīng)急中心專門發(fā)文提示風(fēng)險。

千萬別覺得離自己很遠(yuǎn)。

官方商店 ClawHub 里，曾經(jīng)出現(xiàn)過同一個人上傳了 300 多個偽裝極好的惡意 Skills。

全都是披著金融分析、自動更新的外衣，干著偷偷下載不明文件的勾當(dāng)。

更別提外面那些長得跟官方一模一樣的釣魚鏡像站，簡直防不勝防。

無論你的小龍蝦有多聰明，一定要給它裝上 OpenClaw 官方的Skill Vetter。

https://clawhub.ai/spclaudehome/skill-vetter

不管 3.28 更新了多酷炫的插件鉤子和模型代理，安全檢查永遠(yuǎn)是第一位的。

這東西就像一個極其嚴(yán)苛的 HR。

哪怕你想裝一個僅僅是用來查天氣的簡單 Skills，它也會把底層代碼翻個底朝天。

看看它有沒有偷偷往外傳數(shù)據(jù)，有沒有試圖去讀你的私鑰配置，甚至有沒有去偷窺你的MEMORY.md記憶文件。

只要碰到紅線，直接斃掉。

就算意圖正當(dāng)?shù)饕臋?quán)限過大，它也會給你亮起紅燈，把最終的安裝決定權(quán)交回到你手里。

現(xiàn)在，面對 3.28 版本帶來的一大波新生態(tài)和新玩法，我們終于可以稍微放心地去折騰了。

大家可以去擁抱新的模型，去試新的圖像編輯，去體驗絲滑的異步攔截機(jī)制。

只是，千萬別忘了給自家的賽博秘書穿好防彈衣。

附錄：完整更新日志

重大變更

提供商/通義千問：移除已廢棄的 qwen-portal-auth OAuth 集成（用于 portal.qwen.ai），遷移至 Model Studio，可通過openclaw onboard --auth-choice modelstudio-api-key完成接入。

配置/Doctor：取消兩個月以前的配置自動遷移；極舊的遺留配置鍵現(xiàn)在將直接觸發(fā)驗證失敗，而非在加載時或執(zhí)行openclaw doctor時被自動重寫。

變更

xAI/工具：將內(nèi)置 xAI 提供商遷移至 Responses API，新增一級支持的x_search工具，并根據(jù)已擁有的網(wǎng)頁搜索及工具配置自動啟用 xAI 插件，使內(nèi)置 Grok 的授權(quán)與搜索流程無需手動切換插件即可正常運(yùn)行。

xAI/引導(dǎo)流程：內(nèi)置 Grok 網(wǎng)頁搜索插件現(xiàn)可在openclaw onboard及openclaw configure --section web期間提供可選的x_search配置，包含使用共享 xAI 密鑰的x_search模型選擇器。

MiniMax：新增 image-01 模型的圖像生成提供商，支持圖像生成與圖生圖編輯，并可控制寬高比。

插件/鉤子：在before_tool_call鉤子中新增異步requireApproval，允許插件暫停工具執(zhí)行并通過執(zhí)行審批疊加層、Telegram 按鈕、Discord 交互或任意頻道上的/approve命令向用戶請求確認(rèn)。/approve命令現(xiàn)已統(tǒng)一處理執(zhí)行審批與插件審批，并支持自動降級。

ACP/頻道：為 Discord、BlueBubbles 和 iMessage 新增當(dāng)前會話 ACP 綁定，使/acp spawn codex --bind here能將當(dāng)前聊天轉(zhuǎn)化為 Codex 支撐的工作區(qū)，無需另開子線程；同時在文檔中明確區(qū)分聊天界面、ACP 會話與運(yùn)行時工作區(qū)三者的概念。

OpenAI/apply_patch：為 OpenAI 及 OpenAI Codex 模型默認(rèn)啟用apply_patch，并將其沙箱策略訪問權(quán)限與寫入權(quán)限對齊。

插件/CLI后端：將內(nèi)置的 Claude CLI、Codex CLI 和 Gemini CLI 推理默認(rèn)配置遷移至插件層，新增內(nèi)置 Gemini CLI 后端支持，并將gateway run --claude-cli-logs替換為通用的--cli-backend-logs，同時保留舊參數(shù)作為兼容別名。

插件/啟動：從顯式配置引用中自動加載內(nèi)置提供商與 CLI 后端插件，使內(nèi)置 Claude CLI、Codex CLI 和 Gemini CLI 消息提供商的配置無需在plugins.allow中手動添加條目。

Podman：簡化當(dāng)前無根用戶的容器配置，將啟動輔助工具安裝至~/.local/bin，并在文檔中以宿主機(jī) CLIopenclaw --container ... 工作流替代專用openclaw服務(wù)用戶的方案。

Slack/工具動作：新增顯式的文件上傳 Slack 動作，通過現(xiàn)有 Slack 上傳通道路由文件上傳，支持對頻道和私信設(shè)置可選的文件名、標(biāo)題與注釋。

消息動作/文件：開始將文件優(yōu)先發(fā)送統(tǒng)一至標(biāo)準(zhǔn)的upload-file動作：新增對 Microsoft Teams 和 Google Chat 的顯式支持，并通過upload-file暴露 BlueBubbles 文件發(fā)送能力，同時保留遺留的sendAttachment別名。

插件/MatrixTTS：將自動 TTS 回復(fù)以原生 Matrix 語音氣泡形式發(fā)送，而非通用音頻附件。

CLI：新增openclaw config schema命令，用于打印openclaw.json的 JSON Schema。

配置/TTS：在常規(guī)讀取和密鑰解析時自動遷移遺留語音配置，保留遺留診斷信息供 Doctor 使用，并移除舊內(nèi)置tts. API 密鑰格式在常規(guī)模式下的運(yùn)行時降級邏輯。

內(nèi)存/插件：將壓縮前的內(nèi)存刷新計劃移交至活躍內(nèi)存插件合約，由 memory-core 統(tǒng)一負(fù)責(zé)刷新提示與目標(biāo)路徑策略，不再由核心邏輯硬編碼處理。

MiniMax：精簡模型目錄，僅保留 M2.7，移除遺留的 M2、M2.1、M2.5 和 VL-01 模型。

插件/運(yùn)行時：在插件運(yùn)行時系統(tǒng)命名空間中暴露runHeartbeatOnce，允許插件以顯式的投遞目標(biāo)覆蓋參數(shù)（如heartbeat: { target: "last" }）觸發(fā)單次心跳周期。

Agent/壓縮：在即時回復(fù)與排隊后續(xù)請求中，均保留陳舊用量預(yù)檢壓縮后的 AGENTS 刷新操作。

Agent/壓縮：暴露安全防護(hù)專屬的取消原因，并將良性的手動/compact空操作情況從「失敗」重新標(biāo)記為「已跳過」。

文檔：新增pnpm docs:check-links:anchors用于 Mintlify 錨點(diǎn)驗證，同時保留scripts/docs-link-audit.mjs作為穩(wěn)定的鏈接審計入口。

Tavily：在出站 API 請求中添加X-Client-Source: openclaw標(biāo)頭，使 Tavily 可識別來自 OpenClaw 的流量來源。

修復(fù)

Agent/Anthropic：將未處理的提供商停止原因（如sensitive）轉(zhuǎn)換為結(jié)構(gòu)化的 Assistant 錯誤，而非導(dǎo)致 Agent 運(yùn)行崩潰。

Google/模型：通過傳遞實際運(yùn)行時提供商 ID 并增加模板提供商降級邏輯，修復(fù)所有 Google 提供商別名下 Gemini 3.1 pro、flash 和 flash-lite 的解析問題；修正 flash-lite 前綴排序。

OpenAI Codex/圖像工具：為 Codex 注冊媒體理解能力，并通過 Codex instructions 路由圖像提示，解決因缺少提供商注冊或缺少 instructions 導(dǎo)致圖像分析失敗的問題。

Agent/圖像工具：在未注冊提供商專屬媒體理解提供商時，恢復(fù)通用圖像運(yùn)行時降級邏輯，使 openrouter、minimax-portal 等提供商的圖像分析功能重新可用。

WhatsApp：修復(fù)自聊天私信模式下的無限回聲循環(huán)，該問題會將機(jī)器人自身發(fā)出的回復(fù)再次作為新的用戶入站消息處理。

Telegram/消息分割：以經(jīng)過驗證的 HTML 長度搜索替代按比例估算的文本長度方案，使長消息在單詞邊界處分割而非從單詞中間截斷；當(dāng)標(biāo)簽開銷超出限制時優(yōu)雅降級。

Telegram/投遞：在 Bot 投遞時跳過純空白和被鉤子清空的文本回復(fù)，防止因發(fā)送空文本觸發(fā) GrammyError 400 崩潰。

Telegram/發(fā)送：在全部四個 API 端點(diǎn)使用共享規(guī)范化器驗證replyToMessageId，拒絕非數(shù)字、NaN 及混合內(nèi)容字符串。

Mistral：規(guī)范化 OpenAI 兼容請求標(biāo)志，解決官方 Mistral API 持續(xù)返回 422 狀態(tài)碼（無響應(yīng)體）聊天錯誤的問題。

控制界面/配置：默認(rèn)隱藏敏感原始配置，將空白被屏蔽的編輯器替換為顯式的「解鎖以編輯」?fàn)顟B(tài)，并在不自動暴露密鑰的前提下恢復(fù)原始 JSON 編輯功能。

CLI/zsh：將compdef注冊推遲至compinit可用后執(zhí)行，使 zsh 補(bǔ)全在插件管理器和手動配置場景下均可正常加載。

BlueBubbles/防抖：通過在入隊邊界處清理消息文本，并增加獨(dú)立的合并器防護(hù)，防止防抖刷新處理空消息文本時崩潰。

自動回復(fù)：在頻道投遞前使用嚴(yán)格的單鍵檢測器過濾 JSON 包裝的{"action":"NO_REPLY"}控制信封；當(dāng)文本僅為靜默信封時仍保留媒體內(nèi)容。

ACP/ACPX Agent 注冊表：將 OpenClaw 的 ACPX 內(nèi)置 Agent 鏡像與最新的openclaw/acpx命令默認(rèn)值及內(nèi)置別名對齊，將版本化的 npx 內(nèi)置項固定到精確版本，并阻止未知 ACP Agent ID 在 MCP 代理路徑上降級為原始--agent命令執(zhí)行。

安全/審計：擴(kuò)展網(wǎng)頁搜索密鑰審計范圍，通過邊界安全的內(nèi)置網(wǎng)頁搜索注冊表 shim 識別 Gemini、Grok/xAI、Kimi、Moonshot 和 OpenRouter 憑證。

文檔/FAQ：移除英文和 zh-CN FAQ 條目中已失效的 Xfinity SSL 故障排除交叉鏈接——這兩個章節(jié)均已包含完整的解決方案內(nèi)容。

Telegram：恢復(fù)在論壇主題會話中投遞詳細(xì)工具摘要的功能，使有線程的主題聊天與私信的詳細(xì)模式行為保持一致。

BlueBubbles/CLIAgent：恢復(fù) CLI 路由輪次的入站提示圖像引用，重新應(yīng)用嵌入式運(yùn)行器圖像大小限制，并為兩條 CLI 圖像傳輸路徑添加回歸測試。

BlueBubbles/群組：在群組門控通過后，可選擇性地使用本地 macOS 通訊錄名稱豐富未命名參與者列表，使群組成員上下文可顯示姓名而非僅展示原始電話號碼。

Discord/重連：清理陳舊的網(wǎng)關(guān)套接字，在強(qiáng)制全新重連前清除緩存的恢復(fù)狀態(tài)，并在舊套接字無法關(guān)閉時主動失敗，防止 Discord 恢復(fù)流程因中毒的恢復(fù)狀態(tài)而陷入循環(huán)。

iMessage：通過將reply_to以 RPC 元數(shù)據(jù)形式發(fā)送并從出站消息中剝離多余的指令標(biāo)簽，阻止內(nèi)聯(lián)[[reply_to:...]]標(biāo)簽泄露到已投遞文本中。

CLI/插件：使路由命令與網(wǎng)關(guān)啟動時使用相同的自動啟用內(nèi)置頻道快照，確保 Slack 等已配置的內(nèi)置頻道無需事先重寫配置即可正常加載。

CLI/消息發(fā)送：通過始終將默認(rèn) CLI Agent 接入出站鏡像，將手動執(zhí)行的openclaw message send投遞內(nèi)容重新寫入已解析 Agent 會話的對話記錄。

CLI/引導(dǎo)流程：在 Moonshot 配置菜單中重新顯示 Kimi Code API 密鑰選項，使交互式選擇器將所有 Kimi 配置路徑集中展示。

Agent/狀態(tài)：為最新的 Anthropic 4.6 模型覆蓋使用感知提供商的上下文窗口查詢，使/status顯示正確的 100 萬 token 窗口，而非被低報的共享緩存最小值。

OpenAI/WebSocket：在 WebSocket 工具輪次中保留推理回放元數(shù)據(jù)和工具調(diào)用條目 ID，并在需要完整上下文重發(fā)時啟動全新的響應(yīng)鏈。

OpenAI/WS：為 Responses WebSocket 運(yùn)行恢復(fù)推理塊，并保持推理/工具調(diào)用回放元數(shù)據(jù)完整，防止恢復(fù)的會話在后續(xù)支持推理的輪次中丟失或出錯。

Agent/錯誤：在可用時展示提供商配額與重置詳情，同時將 HTML/Cloudflare 限流頁面保留在通用降級邏輯中，避免將原始錯誤頁面直接呈現(xiàn)給用戶。

ClaudeCLI：將內(nèi)置 Claude CLI 后端切換為流式 JSON 輸出，使看門狗可在長時間運(yùn)行時感知進(jìn)度，并在 Claude 以空結(jié)果行結(jié)束時仍保留會話與用量元數(shù)據(jù)。

ClaudeCLI/MCP：為后臺 Claude CLI 運(yùn)行（包括空服務(wù)器場景）始終傳遞嚴(yán)格生成的--mcp-config覆蓋層，防止 Claude 繼承用戶或全局環(huán)境中的 MCP 服務(wù)器配置。

Agent/嵌入式回復(fù)：在嵌入式運(yùn)行無用戶可見回復(fù)時暴露中途發(fā)生的 429 和過載錯誤，同時保留仍使用遺留mediaUrl的成功純媒體回復(fù)。

聊天/界面：將聊天發(fā)送按鈕遷移至共享的幽靈按鈕主題樣式，同時保持停止按鈕圖標(biāo)在危險狀態(tài)下清晰可辨。

WhatsApp/allowFrom：對有效但被攔截的目標(biāo)顯示專屬的allowFrom策略錯誤，替代具有誤導(dǎo)性的 格式提示。

Agent/冷卻：按模型劃分限流冷卻范圍，防止單個 429 錯誤阻塞同一授權(quán)配置下的所有模型；將指數(shù)級 1 分鐘→1 小時升級策略替換為 30 秒/1 分鐘/5 分鐘的階梯式策略，并在所有模型均受限時向用戶展示倒計時信息。

Agent/嵌入式傳輸錯誤：在嵌入式運(yùn)行的用戶消息與生命周期診斷中，區(qū)分「連接被拒絕」「DNS 查詢失敗」「連接中斷」等常見網(wǎng)絡(luò)故障與真正的超時錯誤。

Telegram/配對：忽略機(jī)器人自身發(fā)送的私信消息更新，防止置頂狀態(tài)卡片等服務(wù)更新觸發(fā)虛假配對請求或重新進(jìn)入入站分發(fā)流程。

Mattermost/回復(fù)：在所有出站回復(fù)分支中，將配對回復(fù)、斜杠命令降級回復(fù)和模型選擇器消息保持在已解析的配置路徑上，確保exec: SecretRefBot Token 正常工作。

Microsoft Teams/配置：在嚴(yán)格配置驗證中接受已有的welcomeCard、groupWelcomeCard、promptStarters以及反饋/反思相關(guān)鍵，使已支持的 Teams 運(yùn)行時設(shè)置不再觸發(fā) Schema 校驗失敗。

MCP/頻道：新增由網(wǎng)關(guān)支撐的頻道 MCP 橋接，提供面向 Codex/Claude 的會話工具、Claude 頻道通知，以及更安全的 stdio 橋接生命周期處理（含重連與路由會話發(fā)現(xiàn)）。

插件/SDK：在插件 SDK 別名解析中傳遞moduleUrl，使安裝在 OpenClaw 目錄外（如~/.openclaw/extensions/）的用戶插件能正確解析openclaw/plugin-sdk/*子路徑導(dǎo)入，并在release:check中加入plugin-sdk:check-exports門控。

配置/網(wǎng)頁抓取：在運(yùn)行時 Schema 驗證中允許已有文檔記載的tools.web.fetch.maxResponseBytes配置項，防止有效配置因「未識別的鍵」而報錯。

消息工具/按鈕：在合并的工具定義中將共享按鈕 Schema 設(shè)為可選，使純action=send調(diào)用在未提供按鈕時不再觸發(fā)驗證失敗。

Agent/OpenAI 兼容工具調(diào)用：對活躍 Assistant 消息和回放歷史中重復(fù)出現(xiàn)的工具調(diào)用 ID 進(jìn)行去重，防止 OpenAI 兼容后端因重復(fù)tool_call_id值返回 HTTP 400 錯誤。

模型/OpenAI 補(bǔ)全：默認(rèn)為非原生 OpenAI 兼容提供商省略工具定義的strict字段，除非用戶顯式重新啟用，確保工具調(diào)用在拒絕該選項的提供商上繼續(xù)正常工作。

插件/上下文引擎：在舊引擎拒絕新prompt字段時，自動去除該字段后重試嚴(yán)格遺留的assemble()調(diào)用，保持對 pre-prompt 插件的兼容性。

CLI/更新狀態(tài)：當(dāng)本地版本與 npm 最新版本一致時，明確顯示「已是最新版本」，同時保持可用性判斷邏輯不變。

守護(hù)進(jìn)程/Linux：停止將僅因 unit 文件中提到 OpenClaw 的非網(wǎng)關(guān) systemd 服務(wù)誤判為重復(fù)網(wǎng)關(guān)，減少 Doctor 和日志中的誤報噪音。

飛書：在監(jiān)控器停止/中止時關(guān)閉 WebSocket 連接，防止幽靈連接持續(xù)存在，避免跨重啟周期的重復(fù)事件處理和資源泄漏。

飛書：對入站消息使用原始的message create_time而非Date.now()作為時間戳，使離線重試消息攜帶正確的創(chuàng)作時間，防止對陳舊指令采取錯誤的 Agent 動作。

控制界面/技能：通過瀏覽器模態(tài)生命周期打開技能詳情對話框，使點(diǎn)擊技能行時面板居中顯示，而非渲染到頁面底部屏幕外。

Matrix/回復(fù)：在入站回復(fù)上下文中包含被引用的投票問題與選項，使 Agent 在用戶回復(fù) Matrix 投票消息時能看到原始投票內(nèi)容。

Matrix/插件：防止插件引導(dǎo)在構(gòu)建運(yùn)行時混合裸路徑和深路徑 matrix-js-sdk 入口時崩潰，避免不相關(guān)的頻道在插件加載期間被連帶中斷。

Agent/沙箱：遵守tools.sandbox.tools.alsoAllow配置，允許顯式的沙箱再授權(quán)移除匹配的內(nèi)置默認(rèn)拒絕工具，并保持沙箱說明與錯誤引導(dǎo)和實際生效的沙箱工具策略一致。

Agent/沙箱：使被攔截工具的引導(dǎo)信息重新支持 glob 匹配，對沙箱說明提示中的會話專屬內(nèi)容進(jìn)行脫敏處理以便安全復(fù)制，并避免在提示中泄露控制字符會話密鑰。

Agent/壓縮：在重試高上下文 LLM 超時前觸發(fā)超時恢復(fù)壓縮，防止嵌入式運(yùn)行反復(fù)重發(fā)超大請求。

Agent/壓縮：在延遲的嵌入式自動壓縮成功后同步sessions.json.compactionCount，使持久化的會話計數(shù)在處理器報告完成后能及時追上。

Agent/故障轉(zhuǎn)移：將 CodexaccountIdToken 提取失敗分類為授權(quán)錯誤，確保模型降級能繼續(xù)至下一個配置候選項。

插件/運(yùn)行時：跨工具、提供商、網(wǎng)頁搜索和頻道引導(dǎo)只復(fù)用兼容的活躍插件注冊表，將/tools/invoke插件加載與會話工作區(qū)對齊，并在固定頻道界面發(fā)生變化時重試出站頻道恢復(fù)，防止插件工具和頻道因運(yùn)行時加載不匹配而消失或重復(fù)注冊。

語音/macOS：修復(fù)系統(tǒng)語音直接失敗后重復(fù)觸發(fā)系統(tǒng)語音的問題，使用 App 語言區(qū)域降級處理共享看門狗計時，并為 macOS 降級路由和語言感知超時策略添加回歸測試。

Discord/網(wǎng)關(guān)清理：在啟動/銷毀清理階段持續(xù)抑制 Carbon 遲到的「重連耗盡」錯誤，防止 Discord 監(jiān)控器關(guān)機(jī)時因遲到的網(wǎng)關(guān)關(guān)閉事件崩潰。

Discord/網(wǎng)關(guān)關(guān)閉：在有意的生命周期停止過程中，將預(yù)期的「重連耗盡」事件視為正常關(guān)機(jī)，防止啟動中止清理邏輯將其誤報為網(wǎng)關(guān)故障。

Discord/網(wǎng)關(guān)關(guān)閉：抑制在拆卸翻轉(zhuǎn)lifecycleStopping之前已緩沖的「重連耗盡」事件，防止陳舊套接字 Discord 重啟導(dǎo)致整個網(wǎng)關(guān)崩潰。

GitHub Copilot/認(rèn)證刷新：將較大的expires_at值視為秒級 epoch 時間戳并限制運(yùn)行時認(rèn)證刷新計時器的上限，防止 Copilot Token 刷新因setTimeout溢出陷入熱循環(huán)。

Agent/狀態(tài)：當(dāng)不存在顯式覆蓋時，在session_status中使用持久化的運(yùn)行時會話模型，并在session_status和/status中均遵守每 Agent 的thinkingDefault設(shè)置。

心跳/運(yùn)行器：確保在心跳運(yùn)行完成及意外運(yùn)行器錯誤后重新設(shè)置間隔計時器，防止定時心跳在中斷的周期后靜默停止。

配置/Doctor：將陳舊的內(nèi)置插件加載路徑從遺留的extensions/*位置重寫至已打包的內(nèi)置路徑，包括目錄名稱不匹配和帶尾部斜杠的配置條目。

WhatsApp/提及：停止將被引用消息中嵌入的提及視為直接提及，防止回復(fù)帶有 @機(jī)器人 的消息時誤觸提及門控。

Matrix：在m.direct種子成功后，將獨(dú)立的雙人房間排除在私信路由之外，同時仍遵守顯式的is_direct狀態(tài)和啟動降級恢復(fù)邏輯。

Agent/Ollama 降級：在 Ollama 非 2xx HTTP 錯誤信息中加入狀態(tài)碼前綴，使 HTTP 503 響應(yīng)重新觸發(fā)模型降級。

飛書/工具：在工具執(zhí)行時，停止將agent-spawner等合成 Agent ID 視為飛書賬戶 ID，確保工具降級使用已配置的默認(rèn)飛書賬戶，而非將合成 ID 當(dāng)作真實的已啟用賬戶。

Google/工具：從 Gemini 工具 Schema 中剝除空的required: []數(shù)組，防止僅含可選參數(shù)的工具觸發(fā) Google 驗證器 400 錯誤。

引導(dǎo)流程/TUI/本地網(wǎng)關(guān)：在配置輸出中顯示已解析的網(wǎng)關(guān)端口，明確無守護(hù)進(jìn)程時本地健康檢查與控制面板的提示信息，并在重復(fù)運(yùn)行和顯式本地網(wǎng)關(guān) URL 場景下保留回環(huán)控制界面認(rèn)證，使本地快速啟動流程能正常恢復(fù)。

TUI/聊天記錄：將系統(tǒng)消息保留為單一邏輯條目，并在完整消息邊界處裁剪溢出，保持包裝后的系統(tǒng)消息間距整潔。

TUI/激活：在 TUI 中對/activation參數(shù)進(jìn)行驗證，拒絕無效值而非靜默強(qiáng)制轉(zhuǎn)換為mention。

Agent/模型切換：在下一個安全重試邊界將/model更改應(yīng)用于活躍的嵌入式運(yùn)行，確保過載或重試中的輪次切換至新選擇的模型，而非繼續(xù)鎖定舊提供商。

Agent/Codex 降級：將 Codexserver_error載荷分類為可降級錯誤，在到達(dá)聊天界面前對 Codex 錯誤載荷進(jìn)行清理，為帶前綴的invalid_request_error載荷保留上下文溢出引導(dǎo)，并從用戶界面文案中省略提供商的request_id值。

內(nèi)存/搜索：跨拆分插件運(yùn)行時共享內(nèi)存嵌入提供商注冊，防止memory-core注冊內(nèi)置適配器后內(nèi)存搜索因「未知提供商」錯誤而失敗。

Discord/Carbon beta：將@buape/carbon更新至最新 beta 版本，并傳遞新的RateLimitError請求參數(shù)，確保 Discord 與上游 beta 版構(gòu)造函數(shù)變更保持兼容。

插件/入站聲明：通過入站聲明鉤子元數(shù)據(jù)傳遞完整的入站附件數(shù)組，同時保留遺留的單一媒體附件字段以保持向后兼容。

插件/Matrix：在入站媒體處理中保留發(fā)送方文件名，將originalFilename轉(zhuǎn)發(fā)至saveMediaBuffer。

Matrix/提及：識別可見標(biāo)簽使用機(jī)器人房間顯示名稱的matrix.to提及，確保requireMention: true的房間在現(xiàn)代 Matrix 客戶端中正確響應(yīng)。

Ollama/關(guān)閉思考：將thinkingLevel=off通過實時 Ollama 擴(kuò)展請求路徑路由，使支持思考的 Ollama 模型能收到頂層think: false參數(shù)，而非靜默生成隱藏的推理 Token。

插件/差異：在打包更新時暫存內(nèi)置@pierre/diffs運(yùn)行時依賴項，確保內(nèi)置差異查看器在全局安裝和更新后仍可正常加載。

插件/差異：不使用 JSON 模塊導(dǎo)入方式加載內(nèi)置 Pierre 主題，使差異渲染在更新版本的 Node.js 構(gòu)建上保持正常工作。

插件/卸載：在卸載頻道插件時移除對應(yīng)的channels. 配置，并保持卸載預(yù)覽與顯式頻道所有權(quán)一致，確保內(nèi)置頻道和共享密鑰不受影響。

插件/Matrix：在選擇出站私信房間和路由未映射的驗證摘要時，優(yōu)先使用顯式私信信號，防止嚴(yán)格的雙人降級房間優(yōu)先于真正的私信房間。

插件/Matrix：在啟動時將 env 支撐的accessToken和passwordSecretRef解析至活躍 Matrix 配置的 env 路徑，并正式接受SecretRef類型的accessToken配置值。

Microsoft Teams/主動私信：當(dāng)存儲了同一用戶的多個會話引用時，對user: 發(fā)送優(yōu)先使用最新的個人會話引用，防止回復(fù)被投遞至陳舊的私信線程。

網(wǎng)關(guān)/插件：在構(gòu)建 HTTP/tools/invoke工具列表時復(fù)用會話工作區(qū)，并強(qiáng)化工具構(gòu)建邏輯以默認(rèn)推斷會話 Agent 工作區(qū)，防止工作區(qū)插件在重復(fù) HTTP 工具調(diào)用時重復(fù)注冊。

Brave/網(wǎng)頁搜索：在請求和緩存鍵生成前將不支持的 Brave 國家過濾器規(guī)范化為ALL，防止VN等從語言區(qū)域派生的值觸發(fā)上游 422 驗證錯誤。

Discord/回復(fù)：在剝除內(nèi)聯(lián)回復(fù)標(biāo)簽時保留前導(dǎo)縮進(jìn)，確保帶回復(fù)標(biāo)簽的純文本和代碼塊保持原有格式。

守護(hù)進(jìn)程/狀態(tài)：從輕量級探測中暴露即時的網(wǎng)關(guān)關(guān)閉原因，并在openclaw daemon status中優(yōu)先顯示這些具體的授權(quán)或配對失敗信息，而非通用超時提示。

Agent/故障轉(zhuǎn)移：默認(rèn)將 HTTP 410 錯誤分類為可重試的超時錯誤，同時仍保留載荷中的顯式會話過期、計費(fèi)和授權(quán)信號。

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

插件/Matrix：通過createRequire(...)加載內(nèi)置的@matrix-org/matrix-sdk-crypto-nodejs，確保 E2EE 媒體發(fā)送與接收在打包的 ESM 構(gòu)建中保持本地原生綁定查找正常工作。

插件/Matrix：對 E2EE 圖像縮略圖使用thumbnail_file加密，對非加密房間的預(yù)覽保留thumbnail_url，確保加密 Matrix 圖像事件保留縮略圖元數(shù)據(jù)，同時不泄露明文預(yù)覽。

Telegram/論壇主題：通過在論壇線程命令上下文中保留主題目標(biāo)，使原生的/new和/reset命令始終路由至當(dāng)前活躍主題。

參考資料：

https://github.com/openclaw/openclaw/releases/tag/v2026.3.28