openclaw v2026.3.13 发布:一次为修复而生的不可变恢复版本,涵盖网关、Agents、UI、移动端、Docker、浏览器与安全的全面升级

一、版本背景说明：为什么会有 v2026.3.13-1

openclaw v2026.3.13 是一个特殊但极其重要的版本。

2026 年 3 月 15 日，openclaw 官方发布了 v2026.3.13-1，这是一个 不可变恢复版本（Immutable Recovery Release）。之所以采用 -1 后缀，是因为 GitHub 的不可变发布机制 不允许在已发布版本号上重新打 Tag。因此：

• • Git Tag 与 GitHub Release 使用 v2026.3.13-1
• • npm 对应版本号仍然是 2026.3.13
• • -1 后缀仅用于 Git 与 Release 层面

本次发布的核心目的只有一个：修复此前 v2026.3.13 Tag / Release 路径损坏的问题，确保版本链路可恢复、可追溯、可稳定使用。

二、核心修复与改进总览

虽然这是一个“恢复发布”，但其实际内容却异常丰富，几乎覆盖了 openclaw 的 核心运行时、Agents 系统、Gateway、浏览器、移动端、Docker、安全、UI、配置、测试与文档 等所有关键模块。

下面将按照模块进行完整、无遗漏的详细解读。

三、会话、压缩与上下文管理（Session & Compaction）

1. 会话压缩一致性修复

• • 修复压缩后校验逻辑，使用完整会话 Token 数量进行健全性检查
• • 修复压缩摘要中 人格设定与语言连续性丢失的问题

2. 会话重置行为优化

• • 会话重置时保留 lastAccountId 与 lastThreadId
• • 重置提示语重新措辞，避免触发 Azure 内容过滤
• • 在 chat.inject 场景下，若转录文件缺失则自动创建

四、Agents 系统稳定性与兼容性增强

1. 记忆与上下文注入修复

• • 避免在大小写不敏感的挂载环境中 重复注入 memory 文件
• • 重放时移除非必要的推理块，避免污染历史会话

2. Provider 与兼容逻辑修复

• • 尊重用户显式设置的兼容覆盖配置
• • 保留本地自定义 Provider 的空 API Key（避免 onboarding 后被清空）
• • 修复非原生 OpenAI completions 的兼容问题
• • 修复启动阶段因配置缺失导致的崩溃风险

3. 子 Agent 与工作区解析

• • 正确解析跨 Agent 场景下的目标工作区
• • 防止多 Agent 场景中上下文错位

五、Gateway 与网络层关键修复

1. 请求与连接稳定性

• • 限制未响应的客户端请求，避免资源泄漏
• • 将受限探测 RPC 视为“降级可达”，而非完全失败
• • 修复控制台 UI 认证绕过逻辑，并对连接失败进行分类

2. SSRF 与安全传输

• • Telegram 线程媒体传输策略正确注入 SSRF 防护
• • Docker 构建上下文中防止 Gateway Token 泄露

3. 平台兼容修复

• • macOS 远程模式下避免 PortGuard 错误终止 Docker Desktop
• • macOS Gateway 提示器遵循 exec-approvals.json 设置

六、浏览器与批处理机制（Browser）

• • 批量操作调度逻辑标准化，支持选择器与批处理并存
• • 修复批处理失败后的限流与重试问题
• • 加强已有会话驱动校验与生命周期管理

七、UI 与前端体验全面优化

1. Chat 与 Dashboard

• • 修复聊天新消息滚动提示样式丢失问题
• • 修复仪表盘聊天历史重复加载风暴
• • 修复超长回复导致的可读性问题
• • 修复聊天上下文提示图标尺寸异常

2. 移动端 UI

• • 移动端导航抽屉与主题变体细节优化
• • Android 聊天设置界面全面重设计
• • iOS 新增 onboarding 欢迎分页引导

3. Codex UI

• • 侧边栏状态、Agent 技能展示、聊天渲染细节整体打磨
• • 默认测试模型从旧 Codex 升级为更新版本

八、Android 与 iOS 平台修复

Android

• • 修复 HttpURLConnection 资源泄漏
• • 使用 Google Code Scanner 优化 onboarding 扫码体验
• • 文档明确说明 Android 应用尚未公开发布

iOS

• • 新增 onboarding 欢迎引导页面，提升首次体验

九、Docker 与运行环境改进

• • 所有 Dockerfile 增加 apt-get upgrade
• • 新增 OPENCLAW_TZ 时区环境变量支持
• • 修复 Docker 服务重装时的工作目录刷新问题
• • 更新 macOS 最低 Node.js 版本要求至 22.16.0

十、配置、Schema 与模型支持修复

• • 修复 agents.list 校验 Schema 中缺失的参数字段
• • 恢复 web fetch firecrawl 配置到运行时 Schema
• • Signal 渠道 Schema 增加群组配置
• • Discovery 模块补全 wideArea 域名配置
• • Gemini 模型 ID 在 Google Vertex Provider 中标准化处理

十一、消息通道与第三方平台修复

Telegram

• • 入站媒体下载失败时支持 IPv4 回退重试

Discord

• • 网关元数据拉取失败时正确处理异常

Slack

• • 新增可选交互式回复指令
• • 插件冲突时快速失败，避免运行期隐患
• • 探测逻辑中移除冗余空值判断

飞书

• • 文件上传时保留非 ASCII 文件名
• • 增加事件级去重，防止重复回复

十二、Cron、Updater 与系统级稳定性

• • 修复孤立 Cron 嵌套通道导致的死锁
• • Updater 服务在缺失调用路径时进行保护
• • Windows 平台重启与清理进程时隐藏多余控制台窗口

十三、测试、文档与工程质量

• • 测试覆盖新增兼容 Schema 校验
• • 测试工具保留定向运行行为
• • 更新并修正多处文档说明与变更日志位置
• • 修复 Brave 成本渲染错误
• • .gitignore 小幅补充，提升工程整洁度

十四、总结：为什么 v2026.3.13 非常值得升级

代码地址：github.com/openclaw/openclaw

尽管 openclaw v2026.3.13-1 是一个恢复型发布，但其实际价值远超“修复 Tag”本身：

• • ✅ 会话与上下文更稳定
• • ✅ Agents 体系更安全、更可控
• • ✅ Gateway 与网络层可靠性显著提升
• • ✅ UI 与移动端体验持续进化
• • ✅ Docker、macOS、Windows 全平台加固
• • ✅ 配置、模型、Schema 更加严谨
• • ✅ 第三方平台接入更健壮