3.13 是一个恢复版本。原始 Git tag 出了问题,所以实际以 v2026.3.13-1 发布。没有 Dashboard 重写,没有新模型集成,没有什么大功能压阵。3.13 的本质是:70+ 补丁,让现有平台更扎实。
以下是真正重要的内容。
性能:Plugin-SDK 内存回归
这个版本最重要的单项修复。Plugin-SDK 中的 chunk 去重逻辑有 bug,导致内存用量比 3.12 翻了大约一倍。如果你升级后发现 OpenClaw 实例吃内存变多了,就是这个原因。
PR #45426 修复了去重逻辑。内存用量应该回到 3.11 时期的水平。如果你跑在 VPS 或者树莓派上,这个修复相当关键。
Android 和 iOS:移动端开始认真了
三个 Android 修复和一个 iOS 改进,说明移动端正在获得真正的关注:
- •聊天设置重新设计(#44894):Android 聊天设置界面做了一次完整的视觉改版——布局更清爽,导航更合理,跟 Web 端体验更一致
- •Google Code Scanner(#45021):新用户引导的二维码扫描现在用 Google 的 Code Scanner API,取代了之前基于摄像头的方式。更可靠,特别是在光线不好的时候
- •HttpURLConnection 泄漏(#43780):HTTP 客户端的连接泄漏导致 Android 长时间运行的会话内存持续增长。现在已正确清理连接
- •欢迎引导页(#45054):引导流程现在有了一个正式的欢迎引导页,在用户进入应用之前先介绍核心概念
这些不算抢眼,但它们是"能在手机上用"和"在手机上好用"之间的差距。
Agent 可靠性:5 项修复
Agent 在 3.13 中变得明显更可预测了:
- 1.重放时丢弃 thinking blocks(#44843):重放 Agent 会话时,thinking blocks 会被重新注入上下文,消耗 token 并偶尔让模型困惑。现在重放时会被剥离
- 2.不再重复注入 memory 文件(#26054):在某些多轮对话流程中,memory 文件会被注入两次,导致上下文污染和 token 浪费
- 3.尊重用户兼容性覆盖(#44432):用户指定的兼容性覆盖在某些服务商路径中被静默忽略。现在全局生效
- 4.保留空白的自定义服务商 API Key(#45631):如果你有意将自定义服务商的 API Key 留空(因为某些服务商不需要),系统会把它当错误处理。已修复
- 5.跨 Agent 工作区路径解析(#40176):当 Agent 引用跨工作区边界的文件时,路径解析可能静默失败。现在能正确解析
单看每个都很小。加在一起,意味着 Agent 不太可能输出垃圾或者在对话中途静默失败了。
UI 打磨
一组让日常使用更顺畅的 UI 修复:
- •移动端导航抽屉和主题变体(#45107):移动端导航抽屉现在能正确跟随主题变体,动画也更流畅
- •侧边栏状态/Agent 技能/聊天渲染(#45451):侧边栏的多项渲染修复——Agent 技能徽章正确显示,状态指示器实时更新,聊天预览不再在单词中间截断
- •聊天上下文提示图标尺寸(#45533):上下文限制警告图标在某些屏幕上过大。现在能正确缩放
- •过大的聊天回复(#45559):长回复在窄屏上会撑破聊天布局。文字现在能正确换行并保持合适的内边距
- •Dashboard 聊天历史重载风暴(#45541):打开 Dashboard 可能触发聊天历史的级联重载。现在只加载一次并缓存
压缩与会话
上下文管理变得更智能了:
- •全会话 token 计数(#28347):一个完整性检查的 token 计数器现在会在整个会话上运行,捕捉压缩过程中静默丢失上下文的情况
- •人设/语言连续性(#10456):压缩后,Agent 的人设和语言设置可能会漂移。现在它们会在压缩边界处被显式保留
- •保留 lastAccountId/lastThreadId(#44773):会话元数据在某些压缩路径中被丢弃,导致 Agent "忘记"自己在操作哪个账户和线程
- •chat.inject 时创建 transcript(#36645):注入的聊天消息现在会正确创建 transcript,因此它们能出现在会话历史中
Docker 与基础设施
- •OPENCLAW_TZ 时区支持(#34119):现在可以通过
OPENCLAW_TZ环境变量为 OpenClaw 容器设置时区。cron 任务不再只能用 UTC 了 - •Dockerfile 中执行 apt-get upgrade(#45384):基础镜像现在在构建时运行
apt-get upgrade,拉取系统包的最新安全补丁 - •网关 token 泄漏预防(#44956):Docker 构建上下文的一个问题可能会在镜像层缓存中意外包含网关 token。
.dockerignore现在明确排除敏感凭证文件
平台修复
各平台特定修复的长尾:
- •SSRF 缓解和 IPv4 回退(#44639、#45327):Telegram webhook 处理现在会验证 URL,并在 IPv6 导致连接问题时回退到 IPv4
- •网关元数据改进(#44397):更好地处理 Discord 网关元数据,让 bot 连接更可靠
- •非 ASCII 文件名处理(#34262):文件名包含中文、日文或其他非 ASCII 字符的文件上传不再静默失败
- •消息去重(#43762):来自飞书 webhook 的重复消息投递现在能被优雅处理
- •群组配置(#27199):Signal 群组支持现在能配合更新后的 config schema 正常工作
- •交互式回复指令(#44607):Slack 交互组件(按钮、菜单)现在能正确将回复指令传回给 Agent
macOS 和 Windows
- •macOS PortGuard Docker Desktop 修复(#13798):PortGuard 错误地将 Docker Desktop 的端口绑定标记为冲突。通过正确的进程检测修复
- •macOS exec-approvals.json(#13707):执行审批持久化文件现在能在 macOS 上正确创建和维护
- •Windows 抑制控制台窗口(#44842):Windows 上启动的子进程不再闪现控制台窗口。一个小事,但把很多人逼疯了
安全
三项安全相关变更:
- •Docker token 泄漏预防(#44956):防止网关 token 被缓存到 Docker 镜像层中
- •不安全 control-ui 连接时保留共享认证(#45088):通过非 HTTPS 连接 control-ui 时(本地开发常见场景),共享认证 token 现在会被保留
- •恢复 control-ui 认证绕过(#45512):3.12 的一个回归破坏了仅本地 control-ui 实例的认证绕过功能。已恢复
其他
| 模块 | 主要变更 |
|---|---|
| 插件 | 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 的所有改进叠加。
现在去更新。