3.13 是一個恢復版本。原始 Git tag 壞了,所以實際以 v2026.3.13-1 發佈。沒有 Dashboard 重寫,沒有新模型整合,沒有什麼大功能壓陣。3.13 的本質是:70+ 修補,讓現有平台更紮實。
以下是真正重要的部分。
效能:Plugin-SDK 記憶體回歸
這個版本最重要的單項修復。Plugin-SDK 中的 chunk 去重邏輯有 bug,導致記憶體用量比 3.12 翻了大約一倍。如果你升級後發現 OpenClaw instance 吃記憶體變多了,就是這個原因。
PR #45426 修復了去重邏輯。記憶體用量應該回到 3.11 時期的水準。如果你跑在 VPS 或樹莓派上,這個修復相當關鍵。
Android 與 iOS:行動端開始認真了
三個 Android 修復和一個 iOS 改進,代表行動端正在獲得真正的關注:
- •聊天設定重新設計(#44894):Android 聊天設定介面做了一次完整的視覺改版——版面更清爽,導覽更合理,跟 Web 端體驗更一致
- •Google Code Scanner(#45021):新使用者引導的 QR 掃描現在用 Google 的 Code Scanner API,取代之前基於鏡頭的做法。更可靠,特別是在光線不佳時
- •HttpURLConnection 洩漏(#43780):HTTP 客戶端的連線洩漏導致 Android 長時間執行的會話記憶體持續增長。現在已正確清理連線
- •歡迎引導頁(#45054):引導流程現在有了正式的歡迎引導頁,在使用者進入 app 前先介紹核心概念
這些不算搶眼,但它們正是「能在手機上用」和「在手機上好用」之間的差距。
Agent 可靠性:5 項修復
Agent 在 3.13 中變得明顯更可預測了:
- 1.重播時丟棄 thinking blocks(#44843):重播 Agent 會話時,thinking blocks 會被重新注入 context,消耗 token 並偶爾讓模型困惑。現在重播時會被移除
- 2.不再重複注入 memory 檔案(#26054):在某些多輪對話流程中,memory 檔案會被注入兩次,導致 context 汙染和 token 浪費
- 3.尊重使用者相容性覆寫(#44432):使用者指定的相容性覆寫在某些供應商路徑中被靜默忽略。現在全域生效
- 4.保留空白的自訂供應商 API Key(#45631):如果你刻意將自訂供應商的 API Key 留空(因為某些供應商不需要),系統會把它當錯誤處理。已修復
- 5.跨 Agent 工作區路徑解析(#40176):當 Agent 引用跨工作區邊界的檔案時,路徑解析可能靜默失敗。現在能正確解析
單看每個都很小。加在一起,代表 Agent 比較不會輸出垃圾或在對話中途靜默失敗了。
UI 打磨
一組讓日常使用更順暢的 UI 修復:
- •行動端導覽抽屜和主題變體(#45107):行動端導覽抽屜現在能正確跟隨主題變體,動畫也更流暢
- •側邊欄狀態/Agent 技能/聊天渲染(#45451):側邊欄的多項渲染修復——Agent 技能徽章正確顯示,狀態指示器即時更新,聊天預覽不再在單字中間截斷
- •聊天 context 提示圖示尺寸(#45533):context 限制警告圖示在某些螢幕上過大。現在能正確縮放
- •過大的聊天回覆(#45559):長回覆在窄螢幕上會撐破聊天版面。文字現在能正確換行並保持適當的 padding
- •Dashboard 聊天歷史重載風暴(#45541):開啟 Dashboard 可能觸發聊天歷史的連鎖重載。現在只載入一次並快取
壓縮與會話
Context 管理變得更聰明了:
- •全會話 token 計數(#28347):一個完整性檢查的 token 計數器現在會在整個會話上執行,捕捉壓縮過程中靜默遺失 context 的情況
- •人設/語言連續性(#10456):壓縮後,Agent 的人設和語言設定可能會飄移。現在它們會在壓縮邊界處被明確保留
- •保留 lastAccountId/lastThreadId(#44773):會話中繼資料在某些壓縮路徑中被丟棄,導致 Agent「忘記」自己在操作哪個帳號和 thread
- •chat.inject 時建立 transcript(#36645):注入的聊天訊息現在會正確建立 transcript,因此它們能出現在會話歷史中
Docker 與基礎設施
- •OPENCLAW_TZ 時區支援(#34119):現在可以透過
OPENCLAW_TZ環境變數為 OpenClaw 容器設定時區。cron 任務不再只能用 UTC 了 - •Dockerfile 中執行 apt-get upgrade(#45384):基礎映像現在在建置時執行
apt-get upgrade,拉取系統套件的最新安全修補 - •Gateway token 洩漏預防(#44956):Docker 建置 context 的一個問題可能會在映像層快取中意外包含 gateway token。
.dockerignore現在明確排除敏感憑證檔案
平台修復
各平台特定修復的長尾:
- •SSRF 緩解和 IPv4 回退(#44639、#45327):Telegram webhook 處理現在會驗證 URL,並在 IPv6 導致連線問題時回退到 IPv4
- •Gateway metadata 改進(#44397):更好地處理 Discord gateway metadata,讓 bot 連線更可靠
- •非 ASCII 檔名處理(#34262):檔名包含中文、日文或其他非 ASCII 字元的檔案上傳不再靜默失敗
- •訊息去重(#43762):來自飛書 webhook 的重複訊息投遞現在能被優雅處理
- •群組設定(#27199):Signal 群組支援現在能配合更新後的 config schema 正常運作
- •互動式回覆指令(#44607):Slack 互動元件(按鈕、選單)現在能正確將回覆指令傳回給 Agent
macOS 與 Windows
- •macOS PortGuard Docker Desktop 修復(#13798):PortGuard 錯誤地將 Docker Desktop 的 port 綁定標記為衝突。透過正確的 process 偵測修復
- •macOS exec-approvals.json(#13707):執行核准持久化檔案現在能在 macOS 上正確建立和維護
- •Windows 抑制主控台視窗(#44842):Windows 上啟動的子 process 不再閃現主控台視窗。一件小事,但把很多人逼瘋了
安全性
三項安全相關變更:
- •Docker token 洩漏預防(#44956):防止 gateway token 被快取到 Docker 映像層中
- •不安全 control-ui 連線時保留共享驗證(#45088):透過非 HTTPS 連線 control-ui 時(本地開發常見情境),共享驗證 token 現在會被保留
- •恢復 control-ui 驗證繞過(#45512):3.12 的一個回歸破壞了僅本地 control-ui instance 的驗證繞過功能。已恢復
其他
| 模組 | 主要變更 |
|---|---|
| 外掛 | channel/binding 衝突時快速失敗(#45628),多項 config schema 修復 |
| 瀏覽器 Agent | 批次操作分發正規化(#45457),會話生命週期加固(#45682) |
| Anthropic | 啟動崩潰修復(#45520) |
| Gemini | google-vertex 的 model-id 正規化(#42435) |
| 測試 | 預設模型更新為 gpt-5.4(#44367) |
新貢獻者
歡迎所有在 3.13 中提交了第一個 PR 的貢獻者。貢獻者總數剛剛突破 1,260,每一個修復都有價值——不管是文件裡的錯字還是關鍵的記憶體洩漏。
---
3.13 是一個穩定性版本。沒有華麗的外表,只有紮實的功夫。如果你在用 3.12,光是記憶體修復就值得升級。如果你用的更舊,Agent 可靠性改進會和 3.11、3.12 的所有改進疊加。
現在就更新。