夜雨聆风
一、版本背景说明：为什么会有 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 更加严谨 • ✅ 第三方平台接入更健壮
我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。
欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。
