一、基础信息
发布时间：2026年4月13日 12:35
发布者：vincentkoc
官方地址：https://github.com/openclaw/openclaw/releases/tag/v2026.4.12
更新说明：本次版本为全面质量提升版，包含9次提交，由vincentkoc、steipete及33位其他贡献者共同开发，版本标签已通过Peter Steinberger（steipete）的验证签名，确保发布安全性。
二、背景信息
OpenClaw是一款本地优先、可私有化部署的开源AI智能体执行网关，核心聚焦多IM渠道集成、主动记忆管理、工具执行与安全隔离，可通过自然语言完成自动化操作、跨平台消息管控、模型调度与任务流执行，广泛应用于开发者测试、企业自动化协作、多渠道运维等场景。其核心优势在于灵活的插件体系、强大的智能体调度能力、全面的安全防护机制及多平台适配性，团队持续通过版本迭代优化功能体验、修复安全隐患、完善生态适配。本次v2026.4.12版本核心聚焦插件加载性能与安全、记忆与梦境系统可靠性、本地模型生态扩展、飞书部署体验优化四大方向，重构插件激活机制，新增LM Studio原生支持，修复上百项稳定性问题，大幅降低部署门槛与运行时资源消耗，进一步提升系统的可用性、安全性与易用性。
三、核心功能新增
（一）插件加载系统全面重构
缩小CLI、提供商、渠道的激活范围至清单声明的必要需求，保留显式作用域与信任边界，集中清单所有者策略；优化启动、命令发现与运行时激活流程，不再加载无关插件运行时，显著提升启动速度、降低内存占用，同时增强插件隔离安全性，减少运行时冲突。相关优化涉及多个提交，确保插件加载的稳定性与规范性。
（二）LM Studio 提供商原生集成
新增捆绑LM Studio提供商，支持一键引导、运行时模型自动发现、流式预加载功能，同时支持本地/自托管OpenAI兼容模型的记忆搜索嵌入，大幅简化本地大模型的部署与使用流程，降低私有化部署门槛，适配更多本地模型应用场景。
（三）主动记忆系统深度优化
默认QMD召回模式切换为搜索，新增搜索路径遥测功能，让记忆召回更可预测、开箱即用体验更佳；修复`mx-claw`等包装器启用时的召回通道偏移问题，确保召回准确性；改进词法回退排名算法，排除混合搜索中的词法权重干扰，进一步提升记忆召回的精准度；同时优化主动记忆插件，启用专属记忆子智能体，自动拉取历史偏好与上下文，无需手动触发。
（四）记忆Wiki 能力增强
新增官方推荐的QMD+桥接模式混合部署方案，配套零工件故障排除指南，帮助用户快速解决部署难题；支持Unicode字母、数字与组合标记的wiki slug与矛盾聚类，避免非ASCII字符导致的异常；限制Unicode文件名段至安全字节长度，彻底解决非ASCII标题出现的崩溃或路径溢出问题，提升记忆Wiki的兼容性。
（五）梦境系统可靠性升级
- 精确消费托管心跳事件，避免重复触发，确保梦境系统稳定运行；轻睡眠置信度基于所有记录的短期信号计算，不再出现`confidence: 0.00`的异常显示；
2. 提升梦境专属内容的晋升阈值，确保多次梦境回访后，内容能突破持久记忆门限，实现有效记忆沉淀；
3. 优化叙事逻辑，停止重复摄入自身叙事转录本，避免冗余数据堆积；新增CLI、doctor工具与梦境UI的显式修复/去重流程，便于用户处理异常数据；
4. 日记时间戳优化，当`dreaming.timezone`未设置时，默认使用主机本地时区，同时显示时区缩写，让`DREAMS.md`文档与UI中的时间显示更直观、准确。
（六）QA 测试体系扩展
- 新增Convex支持的Telegram凭证池租赁能力，配套`openclaw qa credentials`管理命令与代理设置文档，提升Telegram测试的便捷性与安全性；
2. 保留`–runner multipass`模式，QA套件可在临时Linux虚拟机内运行，自动回传测试报告、总结及虚拟机日志，隔离测试环境与生产环境；
3. 新增`openclaw qa telegram`实时测试lane，用于私域机器人两两校验，强化产物处理逻辑，保留Telegram原生命令回复线程，提升测试准确性；
4. 优化QA打包逻辑，避免可选场景配置缺失导致的打包助手崩溃，确保npm分发版本的稳定性。
（七）其他重要新增功能
- macOS Talk模式：新增实验性MLX本地语音提供商，支持显式提供商选择、本地语句播放、中断处理，当本地语音服务异常时可自动降级为系统语音；
2. CLI命令优化：新增`openclaw exec-policy`命令，支持`show`（查看）、`preset`（预设）、`set`（设置）子命令，同步`tools.exec.*`配置与本地执行审批文件，强化节点拒绝、回滚安全与同步冲突检测；
3. 网关能力升级：新增`commands.list` RPC接口，远程网关客户端可通过该接口发现 runtime原生、文本、技能、插件四类命令，获取带表面感知命名与序列化参数元数据的命令信息；
4. 模型提供商配置：新增`models.providers.*.request.allowPrivateNetwork`配置项，支持可信自托管OpenAI兼容端点，当请求传输方式变更时，自动刷新缓存的WebSocket管理器；
5. Control UI优化：聊天框自动加载网关斜杠命令目录，支持dock命令、插件命令与技能别名补全，提升操作便捷性；简化梦境场景与日记界面，稳定等待条目排序，使状态展示更清晰；
6. 文档优化：扩展捆绑提供商文档，补充更丰富的能力说明、环境变量配置与部署引导；完善记忆Wiki文档，新增混合部署方案与故障排除指南；优化文档国际化，修复翻译截断、歧义等问题，提升文档可读性。
四、安全防护全面加固
（一）执行安全三重加固
- 移除解释器类安全bin中的busybox/toybox，减少命令注入风险，强化执行环境安全；
2. 修复空审批人列表意外授予显式执行权限的高危漏洞，确保权限管控的严格性；
3. 扩展shell包装器检测范围，阻止env-argv赋值注入攻击，全方位加固命令执行安全。
（二）网关认证安全升级
清空`.env.example`文件中的示例网关凭证，当检测到用户仍使用复制的占位符令牌或密码时，强制阻止系统启动，彻底杜绝意外使用公开密钥导致的安全隐患，提升网关认证的安全性。
（三）插件与权限安全优化
严格隔离插件作用域与信任边界，确保插件仅能访问清单声明的资源；仅当外部内存槽所有者启用梦境功能时，才加载捆绑的`memory-core`插件，避免不必要的插件加载；保留`plugins.slots.memory = “none”`的禁用语义，支持用户手动禁用记忆插件，提升权限管控的灵活性。
五、多平台渠道深度优化
（一）WhatsApp
- 优化媒体发送逻辑，当`mediaUrl`为空时，自动回退到第一个`mediaUrls`条目，彻底解决网关模式下附件静默丢失、仅投递标题的问题；
2. 集中每个账户的连接所有权，确保重连、登录恢复与出站就绪状态始终绑定当前活跃socket，避免连接漂移导致的功能异常。
（二）Matrix
- 修复非OpenClaw客户端的`@displayName`提及失效问题，同时保持严格的房间提及门控策略，兼顾兼容性与安全性；
2. 新增MSC4357实时标记，支持兼容该标准的Matrix客户端渲染实时打字机动画，且在最终编辑完成后自动停止动画，提升交互体验。
（三）Telegram
- 优化审批按钮回调路由，将其分配至独立序列化通道，避免插件审批点击在智能体运行时出现死锁，提升操作响应速度；
2. 优化直接会话展示逻辑，隐藏Codex规划闲聊内容，仅在有`final_answer`文本时显示回复，防止内部信息泄露；
3. 新增Convex支持的凭证池租赁能力，配套管理命令与文档，提升Telegram测试与部署的便捷性。
（四）Discord
- 优化`openclaw doctor –fix`命令行为，不再重写旧版预览流配置，确保版本降级后无需手动编辑配置即可恢复正常运行；
2. 修复重连时的僵尸回调问题，重连前自动清除陈旧心跳定时器，防止进程崩溃与在途回复丢失；
3. 优化自动线程名称生成逻辑，为推理模型分配足够的输出预算，避免名称生成失败。
（五）iMessage
重试临时`watch.subscribe`启动失败，避免短暂的本地传输故障导致渠道立即重启；清理敏感错误日志，避免泄露原始imsg RPC payload，提升系统安全性与稳定性。
（六）飞书
大幅简化部署流程，完善提供商文档与引导步骤，优化请求处理逻辑，降低企业用户接入门槛，提升飞书渠道的部署与使用体验。
六、体验、兼容性与细节修复
（一）CLI 与部署优化
- 修复`openclaw update`命令因陈旧哈希块导入导致的失败问题，确保版本更新顺利完成；
2. 优化Windows打包安装逻辑，当检测到缺失平台原生依赖时，自动重新安装捆绑的运行时包，确保Windows环境下的正常运行；
3. 增强`openclaw doctor`工具功能，当磁盘上存在`~/.openclaw/agents/<id>/agent`智能体目录，但配置中无对应`agents.list[]`条目时，自动发出警告，提醒用户清理无效目录；
4. 优化CLI音频提供商查询功能，`openclaw infer audio providers –json`命令可正确显示环境变量认证的提供商，同时保持信任工作区提供商环境查询的稳定性。
（二）网关稳定性提升
- 优化网关启动流程，延迟计划服务启动直到所有侧车加载完成；沙箱唤醒时优先恢复渠道，避免侧车阻塞导致远程操作员无法登录；
2. 优化WebSocket心跳机制，不再将心跳广播标记为可丢弃，解决慢客户端或高负载下出现的`tick timeout`断开问题，提升连接稳定性；
3. 保留隔离智能体配置跨运行时重载，确保子智能体任务与心跳覆盖设置在热加载快照陈旧时仍能保持正确；
4. 修复cron任务会话路径问题，为每个隔离运行持久化正确的转录路径，避免cron任务追加到陈旧会话文件；
5. 拆分网关启动与运行时边界，优化生命周期排序、重载状态与关闭行为，提升网关可维护性，不改变现有观测行为；
6. 修复插件子代理运行时漏洞，确保插件子智能体运行时始终发送非空`idempotencyKey`，避免梦境叙事任务因schema验证失败而报错。
（三）记忆系统修复
- 优化短期记忆召回逻辑，支持`memory/**/YYYY-MM-DD.md`下的嵌套每日笔记提供短期召回，同时排除`memory/dreaming/**`下的生成报告，避免梦境内容自我晋升；
2. 修复QMD集合重复问题，停止将旧版小写根记忆文件注册为独立集合，消除重复集合警告，确保QMD优先使用`MEMORY.md`与`memory/`目录；
3. 优化记忆目录监听逻辑，直接监听`memory`目录并忽略非Markdown文件变更，解决macOS+Node 25环境下递归glob监听失效的问题；
4. 修复记忆Wiki缓存问题，插件缓存命中时，自动恢复缓存的记忆能力公共工件，确保记忆相关功能正常显示；
5. 优化QMD配置，支持渠道会话在默认QMD作用域内，同时禁止群组会话；保留显式`memory.qmd.command`路径，创建缺失的智能体工作区，确保QMD子进程能正确找到Node二进制文件。
（四）其他关键修复
- 音频转录修复：修复OpenAI音频转录因FormData字段丢失导致的HTTP 400错误；当所有音频转录尝试失败时，显示真实提供商错误，不再折叠为通用跳过提示；
2. 智能体运行修复：修复智能体运行中收到的跟进消息被静默丢弃的问题，将孤儿活跃轮次用户文本携带至下一个提示，确保消息不丢失；Anthropic重放时保留不可变签名思考安全，修复重试时工具调用丢失问题；
3. 聊天界面修复：隐藏合成转录修复工具结果，防止内部恢复标记泄露到聊天历史，提升用户体验；
4. 插件相关修复：修复`memory-wiki`插件在`plugins.allow`配置生效时的加载问题，确保插件命令能正确解析实时配置；
5. 时间与时区修复：优化日记时间戳显示，确保时区信息清晰，避免时间混淆；
6. 其他细节：修复TUI会话切换时底部活动状态不重置的问题；优化Claude CLI技能传递，支持OpenClaw技能注入；修复Discord TTS语音回复路径，发送Opus语音消息而非普通音频附件。
