一、基础信息
发布时间：2026年4月27日 12:45
发布者：steipete（Peter Steinberger）
官方地址：https://github.com/openclaw/openclaw/releases/tag/v2026.4.25
版本定位：2026年4月正式稳定收官版，核心完成TTS语音全栈升级、插件冷注册表重构、OpenTelemetry全链路可观测、浏览器自动化强化、全平台安装与更新加固，批量修复各类异常问题，全方位提升系统稳定性与易用性，生产环境强制升级。
二、版本概述
本次OpenClaw 2026.4.25版本作为4月正式稳定收官版，实现了前期测试版核心功能的全面落地与优化完善。重点围绕TTS语音体系、插件架构、可观测性、浏览器自动化四大核心领域完成升级，同时优化Control UI交互与PWA功能，全平台加固安装更新流程，深度修复多渠道异常与高频Bug，统一插件SDK规范，确保系统长期稳定运行，为4月迭代画上圆满句号，适配企业生产环境与个人使用场景的各类需求。
三、不兼容变更
本次更新无破坏性功能移除，仅对插件SDK工具结果转换规范进行统一，具体要求如下：
1. 移除仅适配Pi引擎的`api.registerEmbeddedExtensionFactory`方法，取消专属兼容路径；
2. 所有插件统一使用`api.registerAgentToolResultMiddleware`方法，确保Pi与Codex两大引擎的工具行为保持一致，避免兼容性异常。
四、核心功能升级
（一）TTS 语音全栈增强
- 核心命令拓展：新增`/tts latest`指令，可直接朗读最新消息；`/tts chat`指令支持会话级TTS开关控制（on/off/default）；`/tts persona`指令可配置语音角色，满足个性化语音需求；
2. 配置粒度优化：支持全局、智能体、渠道、账号四层配置覆盖，配置优先级深度合并，适配不同场景下的语音播报需求；
3. 厂商全面扩容：新增Azure Speech、小米MiMo、Local CLI、Inworld、Volcengine（火山引擎）、ElevenLabs v3六大TTS提供商，丰富语音选择范围；
4. 渠道原生适配：WhatsApp、飞书、QQ支持原生语音笔记功能，BlueBubbles适配iMessage语音气泡展示，提升语音交互的原生体验。
（二）插件冷注册表体系（架构重构）
- 启动优化：插件索引采用持久化存储，网关启动时跳过全量manifest清单扫描，大幅缩短启动耗时；
2. 运维便捷性：新增`plugins registry`命令，支持查看注册表信息与手动刷新；`plugins list`命令默认读取注册表快照，响应速度更快；
3. 安全保障：插件安装、卸载、更新过程中新增冲突感知机制，仅在配置提交成功后才删除旧文件，避免操作失误导致的系统异常，提升操作安全性。
（三）OpenTelemetry 全链路可观测全覆盖
- 标准指标支持：兼容GenAI标准span，包含`gen_ai.client.token.usage`（Token用量）、`gen_ai.client.operation.duration`（操作耗时）等核心指标，实现标准化可观测；
2. 全链路追踪：覆盖模型调用、工具执行循环、外部消息投递、上下文组装、系统内存压力等全业务流程，实现端到端可观测，便于运维排查问题；
3. 安全脱敏：仅上报低基数指标，不包含Prompt、回复内容、会话ID等敏感信息，保障数据安全；
4. 兼容性适配：支持Prometheus插件集成、OTLP端点覆盖、W3C traceparent透传，适配主流可观测性平台。
（四）浏览器自动化优化
- 功能增强：支持坐标点击、iframe感知角色快照、CDP（Chrome DevTools Protocol）握手重试，操作更精准、稳定；
2. 灵活启动：新增`openclaw browser start –headless`命令，支持一次性无头启动，适配自动化脚本场景；
3. 低速设备适配：针对树莓派等低速主机，可灵活调整CDP就绪超时时间，避免启动失败；
4. 稳定性提升：浏览器崩溃后自动清理`Singleton*`锁，实现并发启动去重，防止端口占用冲突；新增`browser doctor –deep`命令，可实时生成浏览器运行快照，快速排查自动化异常。
（五）Control UI 与安装体验升级
- 交互体验：支持PWA安装与Web Push消息推送，可快速将Control UI添加至桌面，实时接收消息提醒；聊天界面保留Steer注入功能，无需重新输入指令，即可追加补充指令，提升交互效率；
2. 初始化优化：新增TUI初始化流程、上下文模式选择功能，启动问候语精简，简化用户操作流程；
3. 全平台加固：针对Windows（修复pnpm路径空格、计划任务卡死）、macOS（修复LaunchAgent令牌轮换、Homebrew安装异常）、Linux（修复systemd PATH、apt无人值守安装）、Docker（修复依赖拷贝、优化Bonjour默认配置）四大平台，全面修复安装与更新异常，确保全平台稳定部署。
五、模型与渠道优化
（一）模型相关优化
- DeepSeek V4：修复模型思考重放、推理占位符异常问题，OpenCode Go功能同步支持该模型，确保模型运行稳定；
2. OpenAI/Codex：将图像生成超时时间延长至600s，修复OAuth路由异常，提升图像生成成功率；
3. Ollama：适配新`/api/web_search`接口，确保web search功能正常使用；
4. LM Studio：保留模型量化后缀`@iq*`，优化模型匹配逻辑，确保模型调用精准；
5. Gemini：TTS转Opus格式适配WhatsApp语音场景，完善私有网络SSRF白名单配置，支持内网隔离部署。
（二）多渠道深度修复
- WhatsApp：完善TTS语音笔记功能，修复reaction清理异常，支持群组独立`systemPrompt`配置，提升群组交互体验；
2. Telegram：支持原生消息引用，修复轮询冲突问题，优化webhook响应逻辑，提前返回响应避免重试风暴；
3. Discord：支持语音频道独立模型配置，优化审批按钮静默展示逻辑，确保线程会话稳定运行；
4. 飞书：修复流式卡片创建异常、语音转写失败、按钮回调异常等问题，提升飞书渠道稳定性；
5. Matrix：强化交叉签名验证机制，保留`matrix verify self`自我验证命令，确保会话安全，同时优化cron目标保留逻辑；
6. QQBot：新增防自回声功能，适配TTS原生语音输出，支持提醒消息直接调度cron定时任务；
7. Google Meet：优化日历考勤导出功能，完善标签页恢复逻辑，实现浏览器准入自动化，提升会议插件实用性。
六、安全与稳定性优化
（一）权限加固
- 浏览器操作权限：所有浏览器相关方法均要求`operator.admin`权限，强化浏览器操作安全，防范非法操作；
2. MCP权限管控：禁止非所有者调用`cron`、`gateway`等高权限工具，封堵权限提升漏洞，保障系统安全。
（二）配置安全优化
- 日志脱敏：密钥信息在日志中自动脱敏，避免敏感信息泄露；
2. 密钥热重载：Webhook密钥支持热重载，执行`secrets reload`命令后立即生效，无需重启网关，兼顾安全与运维效率；
3. 令牌隔离：设备令牌按范围隔离，避免令牌混用导致的安全风险。
（三）系统稳定性提升
- 心跳修复：修复心跳机制死锁问题，确保系统稳定运行，避免卡顿或崩溃；
2. 会话隔离：优化会话隔离逻辑，避免旧会话残留状态污染新会话与cron任务执行；
3. 运行时回收：MCP运行时执行完成后自动回收，避免进程残留，降低系统资源占用。
（四）日志优化
- 日志轮转：新增日志轮转机制，避免日志文件过大，便于日志管理；
2. 敏感脱敏：全面优化日志敏感信息脱敏逻辑，保障数据安全；
3. 崩溃保护：网关崩溃时不覆盖设备配对文件，避免配对信息丢失，减少运维成本。
七、关键Bug修复（精选）
- 插件相关：修复插件启动卡死、卸载残留文件、更新冲突、Windows平台ESM路径异常等高频问题；
2. 浏览器相关：修复端口占用、崩溃后锁残留、超时重试异常、CDP握手失败等问题，提升自动化可靠性；
3. TTS相关：修复指令剥离异常、音频格式兼容、语音笔记不转文件、重复播报等问题；
4. 会话相关：修复网关重启后会话恢复失败、会话状态卡死、上下文信息泄露、会话压缩异常等问题；
5. 模型相关：修复模型重放异常、空回复重试失效、上下文窗口识别错误、容量不足提示不明确等问题；
6. 渠道相关：修复各平台消息重复、丢失、卡顿，语音转发失败，媒体文件发送异常等问题。
