一、版本背景说明为什么会有 v2026.3.13-1openclaw v2026.3.13 是一个特殊但极其重要的版本。2026 年 3 月 15 日openclaw 官方发布了v2026.3.13-1这是一个不可变恢复版本Immutable Recovery Release。之所以采用-1后缀是因为 GitHub 的不可变发布机制不允许在已发布版本号上重新打 Tag。因此Git Tag 与 GitHub Release 使用 v2026.3.13-1npm 对应版本号仍然是 2026.3.13-1后缀仅用于 Git 与 Release 层面本次发布的核心目的只有一个修复此前 v2026.3.13 Tag / Release 路径损坏的问题确保版本链路可恢复、可追溯、可稳定使用。二、核心修复与改进总览虽然这是一个“恢复发布”但其实际内容却异常丰富几乎覆盖了 openclaw 的核心运行时、Agents 系统、Gateway、浏览器、移动端、Docker、安全、UI、配置、测试与文档等所有关键模块。下面将按照模块进行完整、无遗漏的详细解读。三、会话、压缩与上下文管理Session Compaction1. 会话压缩一致性修复修复压缩后校验逻辑使用完整会话 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 DesktopmacOS 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 配置到运行时 SchemaSignal 渠道 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 更加严谨✅ 第三方平台接入更健壮