一、基础信息
发布时间：2026年4月26日 13:24
发布者：steipete（Peter Steinberger）
官方地址：https://github.com/openclaw/openclaw/releases/tag/v2026.4.25-beta.4
版本定位：4月底重磅测试版，核心聚焦语音播报（TTS）全栈升级、插件启动架构重构、OpenTelemetry（OTel）全链路可观测性落地、浏览器自动化能力增强，同时优化PWA与安装体验，全平台加固安装与更新流程，批量修复上百项渠道异常与稳定性问题，为后续正式版迭代奠定基础。
二、版本概述
本次OpenClaw 2026.4.25-beta.4测试版实现多维度核心能力升级，重点突破语音交互、插件架构、可观测性三大核心领域。TTS语音体系全面扩容，新增多款主流厂商支持与精细化配置；插件启动架构重构为持久化冷注册表模式，大幅提升启动速度与稳定性；OpenTelemetry全链路可观测覆盖全业务流程，助力运维高效排查问题；同时强化浏览器自动化、Control UI交互与PWA功能，全平台加固安装更新体验，深度修复多渠道历史顽疾，进一步完善系统稳定性与易用性，适配测试场景下的各类使用需求。
三、不兼容变更（Breaking）
本次更新无破坏性功能移除，仅对插件SDK工具结果转换规范进行收紧，具体要求如下：
1. 移除仅适配Pi引擎的`api.registerEmbeddedExtensionFactory`兼容路径，统一工具结果转换逻辑；
2. 所有捆绑插件必须使用`api.registerAgentToolResultMiddleware` + `contracts.agentToolResultMiddleware`组合方式，确保Pi与Codex引擎的工具行为保持一致，避免兼容性异常。
四、核心功能升级
（一）TTS 语音体系全栈升级
- 新增核心命令：新增`/tts latest`指令，可直接朗读最新消息；`/tts chat on|off|default`指令，支持会话级TTS开关控制，灵活开启或关闭语音播报；
2. 精细化配置粒度：支持全局、智能体、渠道、账号四层TTS配置，配置优先级深度合并，满足不同场景下的个性化需求；
3. 语音角色拓展：新增TTS Personas语音角色功能，支持语音风格控制与厂商绑定，可根据场景选择适配的语音风格；
4. 厂商全面扩容：新增Azure Speech、小米MiMo、Local CLI、Inworld、Volcengine（火山引擎）、ElevenLabs v3六大TTS提供商，丰富语音选择；
5. 渠道原生适配：WhatsApp、飞书、QQBot支持原生语音笔记，BlueBubbles iMessage适配语音气泡展示，提升语音交互体验。
（二）插件冷注册表体系（重大架构优化）
- 持久化索引：插件索引采用持久化存储，网关启动时不再全量扫描manifest清单，大幅缩短启动耗时；
2. 便捷运维命令：新增`plugins registry`命令，支持查看注册表信息与手动刷新；`plugins list`命令默认读取注册表快照，响应速度更快；
3. 流程标准化：提供商发现、模型目录加载、安装元数据读取全流程走冷注册表，启动流程更稳定、可预测；
4. 安全保障：插件安装、卸载、更新过程中新增冲突感知机制，仅在配置提交成功后才删除旧文件，避免操作失误导致的系统异常。
（三）OpenTelemetry 全链路可观测全覆盖
- 标准指标覆盖：支持GenAI标准span，包含`gen_ai.client.token.usage`（Token用量）、`gen_ai.client.operation.duration`（操作耗时）等核心指标；
2. 全链路追踪：覆盖模型调用、工具执行循环、外部消息投递、上下文组装、系统内存压力等全业务流程，实现端到端可观测；
3. 兼容性适配：支持OTLP端点覆盖、Prometheus插件集成、W3C traceparent透传，适配主流可观测性平台；
4. 安全脱敏：仅导出低基数指标，不包含Prompt、回复内容、会话ID等敏感信息，保障数据安全。
（四）浏览器自动化深度增强
- 功能拓展：支持坐标点击、iframe感知角色快照、CDP（Chrome DevTools Protocol）握手重试，操作更精准、稳定；
2. 灵活启动：新增`openclaw browser start –headless`命令，支持一次性无头启动，适配自动化脚本场景；
3. 低速设备适配：针对树莓派等低速主机，可灵活调整CDP就绪超时时间，避免启动失败；
4. 稳定性优化：浏览器崩溃后自动清理`Singleton*`锁，实现并发启动去重，防止端口占用冲突；
5. 诊断能力：新增`browser doctor –deep`命令，可实时生成浏览器运行快照，便于快速排查自动化异常。
（五）Control UI / PWA / 交互体验升级
- PWA功能：支持PWA安装与Web Push消息推送，可快速将Control UI添加至桌面，实时接收消息提醒；
2. 聊天交互优化：保留Steer注入功能，无需重新输入指令，即可追加补充指令，提升交互效率；
3. 权限面板升级：工具权限面板采用紧凑芯片设计，支持折叠分组与单工具独立开关，权限管理更便捷；
4. 聊天记录优化：隐藏心跳内部上下文，避免污染可见聊天记录，提升阅读体验；
5. 初始化体验：新增Crestodian TUI初始化流程、上下文模式选择功能，启动问候语精简，简化用户操作。
（六）安装/更新全平台加固
- Windows平台：修复pnpm路径包含空格导致的启动异常、计划任务停止卡死问题，优化安装与运维体验；
2. macOS平台：修复LaunchAgent令牌轮换异常、Homebrew安装失败问题，确保系统适配性；
3. Linux平台：修复systemd PATH配置错误、apt无人值守安装异常，完善Linux系统部署支持；
4. Docker平台：修复依赖拷贝不完整、Bonjour服务默认开启导致的资源占用问题，优化容器部署；
5. 插件依赖管理：采用staged缓存机制，自动修复插件运行时依赖冲突，新增版本校验，确保插件正常运行。
五、模型与渠道优化
（一）模型相关优化
- 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`自我验证命令，确保会话安全；
6. QQBot：支持提醒消息直接调度cron定时任务，新增防自回声功能，适配TTS原生语音输出；
7. Slack：确保消息有序发送，修复审批按钮响应异常、线程回复不稳定问题，屏蔽内部日志泄露；
8. 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. 渠道相关：修复各平台消息重复、丢失、卡顿，语音转发失败，媒体文件发送异常等高频问题。
