夜雨聆风作者：永辉 | 发布日期：2026年3月16日
版本概况
OpenClaw 于 2026年3月14日发布了 v2026.3.13-1 版本。这是一个恢复性发布（recovery release），用于修复 v2026.3.13 的 Git tag/Release 路径问题。npm 版本号仍为 2026.3.13，-1 后缀仅用于 Git tag 和 GitHub Release。
本次更新包含 70+项变更，涵盖安全修复、稳定性提升、多平台优化和新功能，涉及 19 位新贡献者。
🔥 安全修复
Docker 网关令牌泄露防护（@xingsy97）防止 gateway token 在 Docker 构建上下文中泄露，建议 Docker 用户立即升级。PR: #44956
macOS PortGuard 误杀 Docker Desktop 修复（@teslamint）防止 PortGuard 在远程模式下误杀 Docker Desktop 进程。PR: #13798
网关未响应客户端请求限制（@Takhoffman）防止网关被大量未响应请求拖垮，提升了系统抗压能力。PR: #45689
🧠 核心稳定性
会话压缩后完整性校验（@efe-arv）使用全会话 token 计数进行压缩后的完整性检查，确保压缩不会丢失关键上下文。PR: #28347
压缩后保留角色人格和语言一致性（@keepitmello）解决了压缩摘要丢失角色设定的问题，长对话中 Agent 的人设不再"走样"。PR: #10456
Cron 隔离会话嵌套死锁修复（@vincentkoc）防止 cron 任务的隔离会话出现嵌套死锁，定时任务更可靠。PR: #45459
Anthropic 启动崩溃修复（@BunsDev）避免了 Anthropic 配置导致的启动崩溃。PR: #45520
插件构建内存回归修复（@TarasShynkarenko）修复了约 2 倍内存使用回归，构建更轻量。PR: #45426
Scope 限制的 Probe RPC 降级处理（@joshavant）将 scope 限制的 probe RPC 视为降级的可达性状态。PR: #45622
📱 移动端
Android
聊天设置界面全新设计（@obviyus）重新设计了设置页面，设备与媒体分组更清晰，布局更紧凑。PR: #44894
引导页 QR 码改用 Google Code Scanner（@obviyus）提升了设备配对时的扫码体验和成功率。PR: #45021
修复 HttpURLConnection 泄漏（@Kaneki-x）TalkModeVoiceResolver 中的连接泄漏问题已解决。PR: #43780
iOS
新增引导欢迎页（@ngutman）新用户首次打开 App 时的引导体验优化。PR: #45054
🖥️ Control UI（控制面板）
Dashboard v2 重大更新（@BunsDev）模块化概览、聊天、配置、Agent、会话视图，新增命令面板，移动端底部标签栏，聊天工具增强（斜杠命令、搜索、导出、置顶消息）。PR: #41503
聊天历史不再疯狂刷新（@BunsDev）修复了 Dashboard 聊天历史重载风暴，页面更稳定。PR: #45541
大回复内容可读性修复（@BunsDev）超长聊天回复不再挤成一团，排版更合理。PR: #45559
聊天上下文通知图标尺寸修复（@BunsDev）PR: #45533
移动端导航抽屉和主题优化（@BunsDev）PR: #45107
控制台认证绕过修复（@sallyom）恢复并分类了连接失败问题。PR: #45512
非安全连接时保留共享认证（@velvet-shark）PR: #45088
聊天新消息滚动按钮 CSS 类恢复（@Astro-Han）PR: #44856
💬 消息渠道
飞书（Feishu）
修复非 ASCII 文件名上传（@fabiaodemianyang）中日韩等非 ASCII 文件名不再乱码，文件上传更可靠。PR: #34262
事件级去重防止重复回复（@yunweibang）从事件层面进行去重，彻底解决了飞书重复消息问题。PR: #43762
Telegram
线程媒体传输策略修复（@frankekn）将媒体传输策略正确传递到 SSRF，修复线程中的媒体发送问题。PR: #44639
IPv4 回退重试（@frankekn）媒体下载失败时自动回退到 IPv4 重试，提升 Telegram 媒体接收成功率。PR: #45327
Discord
网关元数据获取失败处理（@jalehman）优雅处理 Discord gateway 元数据获取失败的情况。PR: #44397
Slack
新增可选交互回复指令（@vincentkoc）PR: #44607
移除 Slack probe 中冗余的 ?? undefined（@Cafexss）PR: #44775
Signal
新增群组配置到 Signal channel schema（@unisone）PR: #27199
🤖 Agent 与会话
会话重置保留 lastAccountId 和 lastThreadId（@Lanfei）PR: #44773
Anthropic thinking blocks 回放时移除（@frankekn）PR: #44843
跨 Agent 子 Agent 工作区路径解析（@moshehbenavraham）修复了跨 Agent 启动子 Agent 时工作区路径无法正确解析的问题。PR: #40176
非 native openai-completions 的显式用户兼容覆盖（@cheapestinference）PR: #44432
会话重置提示词调整避免 Azure 内容过滤器（@xingsy97）PR: #43403
大小写不敏感挂载时内存文件不重复注入（@Lanfei）PR: #26054
chat.inject 时创建缺失的 transcript 文件（@2233admin）PR: #36645
保留本地自定义 provider 的 API Key（@frankekn）onboarding 后不再丢失自定义 provider 的 API Key。PR: #45631
订阅分发去重修复（@frankekn）PR: #44666
🌐 浏览器自动化
浏览器批量操作标准化（@vincentkoc）标准化了批量 act 调度的 selector 和 batch 支持。PR: #45457
浏览器批量操作失败和限制处理跟进（@vincentkoc）PR: #45506
浏览器会话驱动验证和生命周期加固（@odysseus0）PR: #45682
🐳 Docker
新增 OPENCLAW_TZ 时区支持（@Lanfei）Docker 容器中可通过环境变量配置时区。PR: #34119
所有 Dockerfile 添加 apt-get upgrade（@jacobtomlinson）PR: #45384
🔧 配置与模型
agents.list[] 验证 schema 补充缺失的 params 字段（@atian8179）PR: #41171
Gemini 模型 ID 标准化（@scoootscooob）对 google-vertex provider 应用了 Gemini 模型 ID 标准化。PR: #42435
恢复 web fetch firecrawl 运行时 Zod schema 配置（@stim64045-spec）PR: #42583
wideArea Zod 配置 schema 补充缺失的 domain（@ingyukoh）PR: #35615
Ollama 隐藏纯推理输出（@frankekn）PR: #45330
默认测试模型升级到 openai-codex/gpt-5.4（@jrrcdev）PR: #44367
插件通道和绑定冲突快速失败（@vincentkoc）PR: #45628
🖥️ macOS 与 Windows
macOS 最低 Node.js 版本对齐为 22.16.0（@ImLukeF）PR: #45640
macOS exec-approvals.json 设置生效（@sliekens）Gateway prompter 现在正确尊重 exec-approvals.json 设置。PR: #13707
Windows 重启和进程清理时抑制控制台窗口（@MoerAI）PR: #44842
📚 文档与其他
xhigh thinking 帮助文本对齐（@frankekn）PR: #44819
会话 key 文档修正 :dm: → :direct:（@Lanfei）PR: #26506
Brave 成本文档渲染修正（@keelanfh）PR: #44989
Android 文档标注 App 尚未公开发布（@eengad）PR: #23051
Slack 交互回复文档（@vincentkoc）PR: #45463
changelog 信用修复（@frankekn）PR: #44874
Post-release changelog 条目移至 Unreleased（@jalehman）PR: #44691
Updater 服务刷新修复（@vincentkoc）PR: #45452, #45486
Codex 侧边栏状态、Agent 技能和聊天渲染优化（@BunsDev）PR: #45451
测试注解和覆盖（@frankekn, @Takhoffman, @xingsy97）PR: #45346, #45518, #43438
.gitignore 小更新（@Sovtoshi-SC）PR: #42879
🌟 永辉对本次更新的解读
核心价值
v2026.3.13-1 是一个以稳定性为核心的维护版本。70+项变更中绝大多数是 Bug 修复和边界情况处理，说明 OpenClaw 团队正在积极清理技术债务，提升产品成熟度。
对我们的影响
飞书用户受益最大： 非ASCII文件名修复和事件去重直接解决了我们日常使用中的两个痛点——上传中文文件名不再出错，也不会再收到重复消息。
Cron 死锁修复： 我们的定时任务（日报、趋势追踪）运行更稳定，不会因为嵌套会话而死锁。
会话压缩人格保留： 长对话中 Agent 的角色一致性更好了，这对于需要 Agent 保持特定人设的场景非常关键。
Dashboard v2： 控制面板大改版，管理 Agent 和会话将更方便，命令面板和移动端优化提升了管理效率。
浏览器自动化加固： 批量操作标准化和会话生命周期加固，自动化操作更可靠。
升级建议
强烈建议升级。 特别是：
1. Docker 用户务必升级（安全修复，防止 token 泄露） 2. 飞书用户建议尽快更新（去重修复，消息体验大幅提升） 3. Cron 任务多的用户建议更新（死锁修复） 4. 长对话场景建议更新（压缩人格保留）
升级命令
npm install -g openclaw@2026.3.13openclaw gateway restart本文由永辉基于 OpenClaw v2026.3.13-1 Release Notes 编写。完整变更请查看 GitHub Release。
