OpenClaw v2026.5.22 發佈摘要

關鍵變更

OpenClaw v2026.5.22 引入了一系列深層技術優化與穩定性改進，旨在降低延遲、改善記憶體管理，並強化不同作業系統下的系統安全性。

Gateway 效能與延遲

其中最顯著的更新之一是大幅降低了 /models 列舉的延遲。透過在啟動時預熱 provider auth-state map，每次呼叫模型列舉的成本已從大約 20 秒降至 5 毫秒——實現了 4,100 倍的加速。這確保了 Discord 和 Telegram 中的模型選擇器能保持響應，且不再觸發互動逾時。

進一步的效能提升包括：

• Plugin Registry Reuse: Gateway 現在會在分發期間重複使用相容的啟動插件註冊表，避免冗餘載入並降低首次分發延遲。
• Lazy Loading: 啟動時閒置的插件工作、核心 Gateway 方法處理程序，以及內嵌的 ACPX runtime 現在都採用延遲載入，允許 Gateway 健康狀態與就緒訊號在無需等待未使用的處理程序樹的情況下發出。
• Resource Caching: 系統現在會快取 plugin SDK public-surface alias maps，並重複使用不可變的插件元數據快照，以避免在熱路徑上重複進行檔案系統統計。

Agent 與 Sub-agent 協調

父代理（parent agents）與委派工作者（delegated workers）之間的協調已進行精煉，以獲得更好的 token 效率與可靠性：

• Bootstrap Optimization: 使用者現在可以為 sub-agents 配置特定的 bootstrap files 列表（例如，使用 SUBAGENTS.md 代替完整的 SOUL.md 與 USER.md 堆疊），從而降低委派任務的 token 開銷。
• Completion Delivery: Codex-native spawn_agent 的完成結果現在會主動交付回父 session，確保背景工作者結果在 Discord 中是可見的，而無需使用者手動觸發。
• Sub-agent Handoff: 原生的 sub-agent completion handoff 已被簡化；子代理現在會直接向請求者報告其最新的可見助手結果。

記憶體與 Session 管理

為了支援高負載部署，session store 已重新設計以減少記憶體保留：

• Immutable Read APIs: 新的快照與條目級別的讀取 API 取代了可變的全量 store clones，防止了先前在高 session 環境中導致 OOM 錯誤的大型 skillsSnapshot.prompt 字串的重複。
• Locking Hardening: Session 寫入鎖現在會在獲取期間獨立執行 maxHoldMs 策略，防止 Gateway 在大型 session files (>300KB) 導致寫入緩慢時發生凍結。
• Context Budgeting: /status 指令現在會在無法取得最新 provider 使用情況時，揭露估計的 context budget 快照，提供更好的 prompt 壓力可視性。

OS-Specific Hardening

• macOS (launchd): reload handoff script 現在會輪詢以確認卸載完成，以防止啟動過程中的 Input/output error 競態條件。此外，現在會透過在報告失敗前探測服務狀態來優雅地處理併發啟動競態。
• Windows: Codex app-server 現在會驗證指令覆寫（command overrides），以防止格式錯誤的字串（例如，將執行檔與參數組合在一起）被視為單一模組路徑。Windows 安裝程式也已強化，以處理 Git checkout 失敗並在原始主機上引導啟動可攜式 Node.js。

影響

已修復的問題

• Stability: 修復了因工作區啟動條目中未定義的檔名而導致啟動 context building 崩潰的嚴重問題 (#85523)。
• Reliability: 解決了 openclaw agent 在 cron 下忽略 SIGTERM 的問題，導致程序鏈掛起與 RAM 耗盡 (#71710)。
• Connectivity: 修復了迴路 CDP issue，即受管代理（managed proxy）阻礙了瀏覽器的 WebSocket handshake，導致使用者在代理後使用 openclaw browser start 時失效 (#83255)。
• Accuracy: 修復了 Anthropic transport 中精度損失的 bug，即大型整數 ID（例如 Discord snowflakes）在 JSON 解析時被四捨五入 (#47229)。
• User Experience: 修復了 /verbose on 在一般群組 session 中被忽略的 bug，導致工具與進度摘要被隱藏 (#85488)。

整合提升

• xAI/Grok: 增加了對 Grok web_search 的 xAI OAuth profiles 支援，並引入了新的 Grok model aliases。
• Telegram: 透過允許將本地附件路徑作為實際媒體發送，改善了媒體傳遞。
• Discord: 為組件註冊表生命週期增加了可配置的 agentComponents.ttlMs，以支援更長時間運行的非同步工作流。

升級指南

Breaking Changes & Migration

• Workspace Provider Plugins: 為了安全性強化，除非被明確信任，否則在設定模式下不再自動發現工作區來源的 provider plugins。使用者必須將這些 plugin IDs 添加到 config.plugins.allow 列表中以維持現有行為。
• Codex App-Server (Windows): 手動的 appServer.command 指令覆寫若將執行檔與參數組合在單一字串中，現在會被拒絕。使用者應移除這些覆寫覆寫，並依賴受管啟動路徑或提供有效的執行檔路徑。