OpenClaw 在 2026 年 5 月 20 日 发布了 v2026.5.19 版本。这是一个以修复与稳定性为核心的补丁版本,主要致力于解决插件生态、多通道消息路由、移动端体验以及底层架构中的大量细节问题。
通道 (Channels) 关键修复
这是本版本修复量最大的部分,涵盖了 Telegram、Discord、WhatsApp 等多个平台的核心交互问题:
- Telegram:
- 论坛/话题:修复了话题(Forum Topic)消息的路由和序列化问题,确保不同话题间的流量互不阻塞,且回复能正确保留在原话题中。
- 媒体与日志:修复了 421 Misdirected Request 错误的重试机制;改进了媒体组(Media Group)的下载失败提示;在日志中隐藏了敏感的原始更新 ID。
- 交互:保留了回复消息的上下文,修复了
/btw等状态命令中断活跃运行的问题。
- Discord:
- 语音:优化了实时语音会话的连贯性,预缓冲助手播放以避免断续。
- 回复:修复了流式回复预览与最终消息的合并问题,确保进度条消失后能正确显示最终回复。
- 子代理:修复了线程(Thread)中子代理回复的路由,确保回复进入线程而非父频道。
- WhatsApp:
- 文档发送:修复了强制以文档形式发送媒体的逻辑,确保保留原始字节。
- 文件名:为无文件名的附件根据 MIME 类型自动添加后缀(如
.pdf,.csv)。
- 其他通道:
- Feishu (飞书):修复了 DM、群组和广播的消息路由上下文。
- Twitch:修复了聊天令牌的自动刷新机制。
- Signal/QQBot:修复了群组 ID 大小写处理和输入指示器时长。
架构、依赖与底层优化
- 依赖更新:更新
@openclaw/proxyline至 0.3.3;更新 Pi 相关包至 0.75.1。 - Node.js 版本要求:将最低支持版本锁定在 Node.js 22.19,并在源码启动器中强制执行。
- Docker/Podman:引入
OPENCLAW_IMAGE_APT_PACKAGES和OPENCLAW_IMAGE_PIP_PACKAGES构建参数,方便用户在构建镜像时添加自定义依赖。 - 网关性能:通过重叠启动日志记录与插件服务启动,减少重启后的就绪延迟;改进了配置热重载时的插件处理,避免卡死。
- 内存与搜索:优化了 JS 端回退向量路径的扫描逻辑,防止大数据库阻塞主线程;修复了 SQLite-Vec 加载失败的诊断信息。
客户端与 UI 改进
- Mac App:
- 设置页重设计:采用统一的卡片布局,缓存导航状态,优化了权限、语音、技能等面板的视觉效果。
- 交互优化:将侧边栏移至原生标题栏,使其始终可见;优化了配置页的加载速度。
- 状态管理:在断开连接时仍保持菜单命令可用,避免界面卡死。
- Control UI:
- 在协议不匹配错误中包含详细的版本信息,帮助用户快速识别过时的客户端或网关。
- 修复了聊天删除确认框在小屏幕上的溢出问题。
技能 (Skills) 与工具增强
- 技能 CLI:
openclaw skills命令支持--global标志,允许针对共享托管技能进行操作。 - 新/更新技能:
- 梗图生成 (Meme Maker):支持模板搜索和本地/托管渲染。
- Python 调试:新增对 pdb、breakpoint() 和 debugpy 远程附加的支持。
- 代码审查:将 Codex 的闭合审查技能重命名为
autoreview。
- 技能开发:新增
defineToolPlugin及相关 CLI 命令 (build,validate,init),支持类型化的简单工具插件开发。
测试与质量保证 (QA-Lab)
- 基准测试:增加了 Codex vs Pi 的运行时对比场景(Token 效率、工具覆盖率等)。
- 覆盖率报告:新增
openclaw qa coverage --tools命令,强制要求覆盖必要的运行时工具。 - 实时性测试:增加了实时语音会话和工具结果桥接的测试场景。
其他重要修复
- CLI:拒绝高于 65535 的端口号;修复了
openclaw models在插件较多时的卡顿问题。 - 浏览器插件:修复了模态对话框的处理,允许命令行工具回答弹窗;增强了 CDP 连接的诊断能力。
- Codex 集成:修复了插件工具认证配置文件的传递;确保原生代码模式在沙盒中正确路由;修复了子代理任务镜像的清理问题。
- 媒体处理:安装 Sharp 库作为首选图像处理工具,并建立完整的回退链(sips, Windows Imaging, ImageMagick 等)。
v2026.5.19 是一个典型的“打磨”版本。虽然没有引入颠覆性的新功能,但它通过修复大量的边缘情况(特别是 Telegram 论坛和 Discord 语音)和优化开发者工具(Skill SDK),显著提升了系统的稳定性和开发效率。如果你在使用复杂的多通道路由或自定义插件,建议更新此版本。