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)時很多朋友連控制臺都進不去，還以為自己辛辛苦苦養(yǎng)的蝦死透了。

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

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

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

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

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

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

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

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

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

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

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

但，能力越強，水越深。

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

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

千萬別覺得離自己很遠。

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

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

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

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

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

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

這東西就像一個極其嚴苛的 HR。

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

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

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

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

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

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

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

附錄：完整更新日志

重大變更

提供商/通義千問：移除已廢棄的 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)與搜索流程無需手動切換插件即可正常運行。

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命令向用戶請求確認。/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 會話與運行時工作區(qū)三者的概念。

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

插件/CLI后端：將內(nèi)置的 Claude CLI、Codex CLI 和 Gemini CLI 推理默認配置遷移至插件層，新增內(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，并在文檔中以宿主機 CLIopenclaw --container ... 工作流替代專用openclaw服務(wù)用戶的方案。

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

消息動作/文件：開始將文件優(yōu)先發(fā)送統(tǒng)一至標準的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ī)模式下的運行時降級邏輯。

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

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

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

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

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

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

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

修復(fù)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

CLI/消息發(fā)送：通過始終將默認 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 運行恢復(fù)推理塊，并保持推理/工具調(diào)用回放元數(shù)據(jù)完整，防止恢復(fù)的會話在后續(xù)支持推理的輪次中丟失或出錯。

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

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

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

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

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

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

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

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

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

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

Microsoft Teams/配置：在嚴格配置驗證中接受已有的welcomeCard、groupWelcomeCard、promptStarters以及反饋/反思相關(guān)鍵，使已支持的 Teams 運行時設(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)頁抓取：在運行時 Schema 驗證中允許已有文檔記載的tools.web.fetch.maxResponseBytes配置項，防止有效配置因「未識別的鍵」而報錯。

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

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

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

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

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

守護進程/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)生命周期打開技能詳情對話框，使點擊技能行時面板居中顯示，而非渲染到頁面底部屏幕外。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

內(nèi)存/搜索：跨拆分插件運行時共享內(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/提及：識別可見標簽使用機器人房間顯示名稱的matrix.to提及，確保requireMention: true的房間在現(xiàn)代 Matrix 客戶端中正確響應(yīng)。

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

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

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

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

插件/Matrix：在選擇出站私信房間和路由未映射的驗證摘要時，優(yōu)先使用顯式私信信號，防止嚴格的雙人降級房間優(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ū)，并強化工具構(gòu)建邏輯以默認推斷會話 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ù)標簽時保留前導(dǎo)縮進，確保帶回復(fù)標簽的純文本和代碼塊保持原有格式。

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

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

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

插件/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/論壇主題：通過在論壇線程命令上下文中保留主題目標，使原生的/new和/reset命令始終路由至當(dāng)前活躍主題。

參考資料：

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