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 更加严谨
- ✅ 第三方平台接入更健壮