一、版本更新概覽

openclaw于2026年3月25日正式發(fā)布v2026.3.24版本，本次更新聚焦OpenAI生態(tài)兼容、智能體工具能力、多平臺(tái)交互體驗(yàn)、技能安裝與管理、CLI與容器支持、UI界面優(yōu)化、運(yùn)行時(shí)兼容性等核心方向，同時(shí)修復(fù)了大量安全、穩(wěn)定性與多平臺(tái)適配問(wèn)題，全面提升了AI智能體網(wǎng)關(guān)的可用性、兼容性與安全性。

二、Breaking Changes（重大變更） 1. Gateway/OpenAI兼容性升級(jí)

• ? 新增/v1/models與/v1/embeddings接口，實(shí)現(xiàn)與OpenAI生態(tài)的基礎(chǔ)接口對(duì)齊

• ? 在/v1/chat/completions與/v1/responses接口中，支持顯式模型覆蓋轉(zhuǎn)發(fā)，大幅提升客戶端與RAG系統(tǒng)的兼容性

• ?/tools接口僅返回當(dāng)前智能體可立即使用的工具，精準(zhǔn)匹配智能體可用能力

• ? 新增緊湊默認(rèn)視圖，同時(shí)提供可選的詳細(xì)模式，兼顧簡(jiǎn)潔性與信息完整性

• ? Control UI新增實(shí)時(shí)“Available Right Now”（當(dāng)前可用）區(qū)域，讓用戶在發(fā)起請(qǐng)求前清晰知曉可用工具，提升交互效率

• ? 遷移至官方Teams SDK，遵循AI-agent用戶體驗(yàn)最佳實(shí)踐

• ? 支持1:1流式回復(fù)、帶提示詞啟動(dòng)器的歡迎卡片、反饋與反思功能、信息狀態(tài)更新、輸入指示器、原生AI標(biāo)簽

• ? 新增消息編輯與刪除支持，無(wú)明確目標(biāo)時(shí)提供線程內(nèi)回退機(jī)制，適配Teams消息交互邏輯

• ? 為捆綁技能（coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather）添加一鍵安裝配置

• ? CLI與Control UI可在依賴缺失時(shí)自動(dòng)提示并完成依賴安裝，簡(jiǎn)化技能部署流程

• ? 新增狀態(tài)篩選標(biāo)簽（全部/就緒/需設(shè)置/已禁用），并顯示各狀態(tài)技能數(shù)量

• ? 替換內(nèi)聯(lián)技能卡片為點(diǎn)擊詳情對(duì)話框，展示技能依賴、開(kāi)關(guān)、安裝操作、API密鑰輸入、源元數(shù)據(jù)與主頁(yè)鏈接，實(shí)現(xiàn)一站式技能管理

• ? 恢復(fù)直接交付的富文本回復(fù)一致性，確保交互體驗(yàn)統(tǒng)一

• ? 自動(dòng)將簡(jiǎn)單的末尾Options:行渲染為按鈕/選擇框，提升交互便捷性

• ? 優(yōu)化Slack交互設(shè)置默認(rèn)值，將回復(fù)控件與插件交互處理程序隔離，避免功能沖突

• ? 新增--container參數(shù)與OPENCLAW_CONTAINER環(huán)境變量，支持在運(yùn)行中的Docker或Podman OpenClaw容器內(nèi)執(zhí)行openclaw命令，適配容器化部署場(chǎng)景

• ? 新增可選autoThreadName: "generated"命名模式，新自動(dòng)創(chuàng)建的線程可通過(guò)LLM異步生成簡(jiǎn)潔標(biāo)題

• ? 保留原有基于消息的命名作為默認(rèn)，兼顧兼容性與個(gè)性化需求

• ? 新增before_dispatch鉤子，提供規(guī)范的入站元數(shù)據(jù)

• ? 路由處理后的回復(fù)通過(guò)標(biāo)準(zhǔn)最終交付路徑，保留TTS與路由交付語(yǔ)義，確保功能一致性

• ? 智能體工作區(qū)文件行轉(zhuǎn)換為可展開(kāi)的

  組件，支持懶加載內(nèi)聯(lián)Markdown預(yù)覽

• ? 新增全面的.sidebar-markdown樣式，適配標(biāo)題、列表、代碼塊、表格、塊引用、details/summary等元素，優(yōu)化文檔預(yù)覽體驗(yàn)

• ? 重新設(shè)計(jì)智能體工作區(qū)文件預(yù)覽對(duì)話框，采用磨砂背景、適配尺寸面板與樣式化標(biāo)題

• ? 集成@create-markdown/preview v2系統(tǒng)主題，支持富Markdown渲染（標(biāo)題、表格、代碼塊、標(biāo)注、塊引用），并自動(dòng)適配應(yīng)用明暗設(shè)計(jì)令牌

• ? 替換水平藥丸式子部分導(dǎo)航為可折疊樹(shù)形側(cè)邊欄，使用展開(kāi)箭頭與縮進(jìn)子行，提升配置界面的層級(jí)清晰度與操作便捷性

• ? 將缺失依賴標(biāo)簽從“missing”優(yōu)化為“needs setup”，表述更友好

• ? 在openclaw skills info輸出中，補(bǔ)充API密鑰設(shè)置指南（密鑰獲取途徑、CLI保存命令、存儲(chǔ)路徑），降低用戶配置門檻

• ? API密鑰編輯器對(duì)話框新增“Get your key”主頁(yè)鏈接與存儲(chǔ)路徑提示

• ? 保存確認(rèn)消息中顯示配置路徑，方便用戶定位配置文件

• ? 默認(rèn)智能體模型選擇器下拉框新增“Not set”占位符，明確未選擇狀態(tài)

• ? 將Node 22支持最低版本降至22.14+，同時(shí)推薦使用Node 24

• ? 避免npm安裝與自動(dòng)更新導(dǎo)致Node 22.14用戶停留在舊版本，提升兼容性

• ? 在openclaw update執(zhí)行全局包安裝前，預(yù)檢查目標(biāo)npm包的engines.node要求

• ? 過(guò)時(shí)Node運(yùn)行時(shí)會(huì)觸發(fā)清晰的升級(jí)提示，而非嘗試安裝不支持的最新版本，減少更新失敗問(wèn)題

• ? 出站媒體/本地文件：使出站媒體訪問(wèn)與配置的文件系統(tǒng)策略對(duì)齊，關(guān)閉workspaceOnly時(shí)，主機(jī)本地文件與入站媒體路徑可正常發(fā)送；嚴(yán)格工作區(qū)隔離的智能體保持沙箱化

• ? 安全/沙箱媒體分發(fā)：關(guān)閉mediaUrl/fileUrl別名繞過(guò)漏洞，防止出站工具與消息操作突破媒體根目錄限制

• ? 嵌入式運(yùn)行/密鑰：未解析的SecretRef配置不再導(dǎo)致嵌入式智能體運(yùn)行崩潰，必要時(shí)回退到已解析的運(yùn)行時(shí)快照

• ? 網(wǎng)關(guān)/重啟哨兵：重啟后通過(guò)心跳喚醒中斷的智能體會(huì)話，而非僅發(fā)送盡力而為的重啟通知；臨時(shí)失敗時(shí)重試出站交付一次；保留顯式線程/主題路由，確保回復(fù)送達(dá)正確的Telegram主題或Slack線程

• ? Docker/安裝：通過(guò)openclaw-gateway路由安裝時(shí)的配置寫入，避免預(yù)啟動(dòng)openclaw-cli共享網(wǎng)絡(luò)命名空間循環(huán)，解決全新Docker安裝在網(wǎng)關(guān)啟動(dòng)前失敗的問(wèn)題

• ? 網(wǎng)關(guān)/通道：保持通道啟動(dòng)順序，同時(shí)隔離各通道啟動(dòng)失敗，單個(gè)故障通道不再阻塞后續(xù)通道啟動(dòng)

• ? Discord/網(wǎng)關(guān)監(jiān)控：將網(wǎng)關(guān)錯(cuò)誤處理集中到生命周期管理的監(jiān)控器中，統(tǒng)一分類早期、活躍、后期拆除階段的Carbon網(wǎng)關(guān)錯(cuò)誤，避免進(jìn)程崩潰

• ? Discord/超時(shí)：入站Discord工作線程在最終回復(fù)開(kāi)始前超時(shí)，發(fā)送可見(jiàn)的超時(shí)回復(fù)，包含創(chuàng)建的自動(dòng)線程目標(biāo)與排隊(duì)運(yùn)行順序

• ? WhatsApp/群組：跟蹤網(wǎng)關(guān)最近發(fā)送的消息ID，僅抑制匹配的群組回聲，保留所有者的/status、/new、/activation命令

• ? WhatsApp/回復(fù)檢測(cè)：通過(guò)解包botInvokeMessage負(fù)載并從creds.json讀取selfLid，恢復(fù)群組隱式回復(fù)檢測(cè)，確保基于回復(fù)的提及能觸達(dá)機(jī)器人

• ? Telegram/論壇主題：當(dāng)Telegram省略論壇元數(shù)據(jù)時(shí)，恢復(fù)，支持原生命令、交互回調(diào)、入站消息上下文與回退錯(cuò)誤回復(fù)

• ? Telegram/出站錯(cuò)誤：保留可操作的403成員/阻止/踢出詳情，將機(jī)器人非成員視為永久交付失敗，停止重試無(wú)效聊天

• ? Telegram/照片：預(yù)檢查Telegram照片尺寸與寬高比規(guī)則，圖像元數(shù)據(jù)無(wú)效或不可用時(shí)回退為文檔發(fā)送，解決PHOTO_INVALID_DIMENSIONS上傳失敗問(wèn)題

• ? Slack/運(yùn)行時(shí)默認(rèn)值：減少Slack私信回復(fù)開(kāi)銷，恢復(fù)Codex自動(dòng)傳輸；收緊Slack/網(wǎng)頁(yè)搜索運(yùn)行時(shí)默認(rèn)值，優(yōu)化私信預(yù)覽線程、緩存范圍、警告去重與顯式網(wǎng)頁(yè)搜索選擇加入

• ? ACP/直接聊天：最終TTS未生成音頻時(shí)，始終交付終端ACP結(jié)果，即使塊文本已提前流式傳輸；跳過(guò)冗余的空文本最終合成

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

openclaw v2026.3.24版本是一次兼顧兼容性、易用性、安全性與穩(wěn)定性的全面升級(jí)。在OpenAI生態(tài)適配、智能體工具管理、多平臺(tái)交互優(yōu)化上實(shí)現(xiàn)重大突破，同時(shí)通過(guò)CLI與容器支持、UI界面重構(gòu)、運(yùn)行時(shí)兼容性調(diào)整，大幅降低了部署與使用門檻；問(wèn)題修復(fù)則聚焦媒體安全、網(wǎng)關(guān)穩(wěn)定性、多平臺(tái)適配等核心痛點(diǎn)，為企業(yè)級(jí)與個(gè)人用戶提供了更可靠、更高效的AI智能體網(wǎng)關(guān)服務(wù)。

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