OpenClaw v2026.3.13-1 版本更新解析：63项改动全面解读

OpenClaw 开源 AI 智能体网关迎来 v2026.3.13-1 恢复版本，包含 63 项变更，涵盖会话压缩、多平台适配、安全加固、性能优化等关键领域。

背景：为什么是 v2026.3.13-1？

本次版本号带 -1 后缀，原因是 GitHub 的不可变 Release 机制不允许在 v2026.3.13 发布后重用该标签。因此团队使用 v2026.3.13-1 进行恢复发布。需要注意的是：

npm 版本号 仍然是 2026.3.13，不带 -1
-1 后缀仅用于 Git Tag 和 GitHub Release

一、核心修复：会话压缩与上下文管理

1.1 修复压缩后 Token 计数校验

PR #28347 | @efe-arv

压缩（compaction）是 OpenClaw 管理长对话上下文的核心机制。此前，压缩完成后的合理性检查使用的是局部 Token 计数，可能导致校验不准确。本次修复改为使用全会话 Token 计数进行校验，确保压缩后上下文完整性的判断更加可靠。

影响：使用长对话场景的用户会注意到压缩后的上下文更稳定，不会出现因校验失败导致的异常中断。

1.2 保留压缩摘要中的人设和语言连续性

PR #10456 | @keepitmello

这是对用户体验影响最大的修复之一。在之前的版本中，当对话被压缩时，AI 的人设（persona）和语言风格可能丢失，导致压缩后的回复"变了个人"。本次修复确保压缩摘要保留原始的人设和语言设定。

实际场景：假设你让 AI 用"技术专家"的身份全程用中文回答问题，对话变长触发压缩后，AI 依然保持技术专家的风格和中文回复，而不是突然切换语言或人设。

1.3 会话重置时保留关键状态

PR #44773 | @Lanfei

修复了会话重置时 lastAccountId 和 lastThreadId 被意外清除的问题。这意味着重置会话后，系统仍能正确关联到之前的账户和线程，避免上下文丢失。

二、多平台适配：Telegram、Discord、飞书、Slack、Signal

2.1 Telegram 修复

PR	修复内容
#44639	将媒体传输策略（thread media transport policy）传递到 SSRF 安全检查中
#45327	媒体下载失败时自动回退到 IPv4 重试

2.2 Discord 修复

PR #44397 | @jalehman

修复了 Discord Gateway 元数据获取失败时未正确处理的问题，提升了 Discord 频道的连接稳定性。

2.3 飞书（Feishu/Lark）修复

PR	修复内容
#34262	修复文件上传时非 ASCII 文件名丢失的问题（中文文件名终于可以正常使用了）
#43762	添加事件级去重，防止飞书重复回复

2.4 Slack 增强

PR #44607 | @vincentkoc

新增可选的交互式回复指令（interactive reply directives），让 Slack 上的交互体验更丰富。

2.5 Signal 修复

PR #27199 | @unisone

修复了 Signal 频道的 groups 配置缺失问题，补全了 Zod 配置 Schema。

三、Agent 智能体改进

3.1 回放时丢弃 Anthropic Thinking Blocks

PR #44843 | @frankekn

在 Agent 回放（replay）会话时，Anthropic 的 thinking blocks 会被丢弃。这是一个重要的性能优化------thinking blocks 通常很大，在回放时不仅浪费 Token 还会拖慢速度。

3.2 大小写不敏感挂载上避免重复注入记忆文件

PR #26054 | @Lanfei

在 macOS 和 Windows 等大小写不敏感的文件系统上，之前可能出现记忆文件被注入两次的问题。本次修复通过规范化路径比较解决了这个问题。

3.3 修复跨 Agent 子 Agent 的工作空间解析

PR #40176 | @moshehbenavraham

当主 Agent 派生子 Agent 执行任务时，子 Agent 需要知道自己的工作空间路径。此前这个解析在某些情况下会失败，现在已修复。

3.4 保留本地自定义 Provider 的空白 API Key

PR #45631 | @frankekn

修复了 onboarding 之后本地自定义 Provider 的空白 API Key 被意外清除的问题。对于使用自建模型或本地推理的用户来说，这是一个关键修复。

3.5 重写会话重置提示词以避免 Azure 内容过滤

PR #43403 | @xingsy97

Azure OpenAI 的内容过滤机制有时会误判会话重置的系统提示词。本次重写了提示词措辞，减少了误触发过滤的概率。

四、安全加固

4.1 防止 Docker 构建上下文中的 Gateway Token 泄漏

PR #44956 | @xingsy97

这是一个重要的安全修复。此前在 Docker 构建过程中，Gateway Token 可能被包含在构建上下文中，存在泄漏风险。现在已堵住这个漏洞。

4.2 macOS Gateway Prompter 遵守 exec-approvals.json 设置

PR #13707 | @sliekens

macOS 上的 Gateway 提示器现在会正确读取 exec-approvals.json 中的审批设置，确保执行权限配置在所有入口生效。

4.3 插件系统快速失败：频道和绑定冲突检测

PR #45628 | @vincentkoc

当插件存在频道（channel）或绑定（binding）冲突时，系统现在会立即报错并停止加载，而不是静默运行导致不可预期行为。

五、Docker 与部署

5.1 时区支持

PR #34119 | @Lanfei

新增 OPENCLAW_TZ 环境变量，允许在 Docker 容器中设置时区。此前 Docker 容器默认使用 UTC，导致定时任务等时间相关功能不准确。

bash 复制代码

docker run -e OPENCLAW_TZ=Asia/Shanghai ...

5.2 Dockerfile 安全更新

PR #45384 | @jacobtomlinson

所有 Dockerfile 现在包含 apt-get upgrade，确保基础镜像中的安全补丁被及时应用。

六、UI/UX 改进

6.1 Android 聊天设置 UI 重新设计

PR #44894 | @obviyus

Android 端的聊天设置界面进行了全面重设计。

6.2 iOS 新增引导欢迎页

PR #45054 | @ngutman

iOS 端新增 onboarding welcome pager，新用户体验更加友好。

6.3 移动端导航和主题优化

PR #45107 | @BunsDev

移动端导航抽屉和主题变体进行了多项细节优化。

6.4 修复 Dashboard 聊天历史记录重载风暴

PR #45541 | @BunsDev

此前 Dashboard 页面会不必要地反复重新加载聊天历史，现在已修复，大幅减少网络请求。

6.5 其他 UI 修复

PR	修复内容
#45533	聊天上下文通知图标尺寸修复
#45559	超长聊天回复保持可读性
#44856	滚动按钮上的 chat-new-messages 类恢复
#45451	Codex 侧边栏状态、Agent 技能和聊天渲染优化

七、性能优化

7.1 构建产物去重：修复 2 倍内存回归

PR #45426 | @TarasShyn

Plugin SDK 的构建产物存在重复 chunks 问题，导致约 2 倍的内存占用回归。本次修复通过去重 chunks 解决了这个问题，对构建性能有显著提升。

八、平台特定修复

8.1 Windows

PR #44842 | @MoerAI

修复了重启和进程清理期间弹出可见控制台窗口的问题，用户体验更干净。

8.2 macOS

PR	修复内容
#13798	防止 PortGuard 在远程模式下杀死 Docker Desktop
#45640	最低 Node.js 版本与运行时守卫对齐（22.16.0）

8.3 Android

PR	修复内容
#43780	修复 TalkModeVoiceResolver 中的 HttpURLConnection 泄漏
#45021	使用 Google Code Scanner 替代原有二维码扫描

九、其他值得关注

9.1 测试默认模型更新

PR #44367 | @jrrcdev

测试中的默认模型从 openai-codex/gpt-5.3-codex 更新为 openai-codex/gpt-5.4。

9.2 Ollama 本地推理输出隐藏

PR #45330 | @frankekn

隐藏 Ollama 原生推理专用输出，让界面更简洁。

9.3 Gemini 模型 ID 规范化

PR #42435 | @scoootscooob

对 Google Vertex Provider 中的 Gemini 模型 ID 进行规范化处理，修复模型调用失败问题。

9.4 CLI xhigh thinking 帮助文本对齐

PR #44819 | @frankekn

对齐了 CLI 中 xhigh thinking 模式的帮助文本描述。

社区贡献

本次版本迎来了 18 位新贡献者的首次提交，是 OpenClaw 社区增长最快的版本之一。总计有超过 30 位贡献者参与了本版本的开发。

延伸阅读

《OpenClaw超级个体实操手册》纸质书已上市！ 清华大学出版社出版，在开源教程基础上全面重写+逐条验证。

144条CLI命令对照官方文档逐条核对（教程中约60%已删除或修正）

9套配置模板全部在v2026.3.7+实际跑通

新增安全防护指南 + 国产Claw全景指南

🛒 京东专属购买链接（¥42，原价¥59.8）

升级建议

推荐升级：如果你正在使用 v2026.3.12，建议升级到 v2026.3.13-1，尤其是以下场景：
- 使用长对话（会话压缩修复）
- 使用飞书中文文件名上传
- 使用 Docker 部署（安全修复 + 时区支持）
- 使用自定义 Provider 或本地模型
npm 升级：
bash 复制代码
```
npm install -g openclaw@2026.3.13
```

Docker 升级：

bash 复制代码

docker pull openclaw/openclaw:v2026.3.13-1

总结

v2026.3.13-1 虽然是一个恢复版本，但内容量非常充实。从变更分布来看：

类别	数量
Bug 修复	~45
新功能/增强	~8
文档改进	~5
安全修复	3
性能优化	2

核心亮点：会话压缩的人设保持、飞书中文名修复、Docker 时区支持、安全加固。这些改进让 OpenClaw 在生产环境中的可靠性进一步提升。

本文基于 OpenClaw v2026.3.13-1 Release Notes 整理分析。
项目地址：https://github.com/openclaw/openclaw
教程项目：https://github.com/xianyu110/awesome-openclaw-tutorial