OpenClaw 2026.4.25-beta 深度前瞻:TTS 全面重构、插件冷注册表、可观测性覆盖三大主线齐发-夜雨聆风

OpenClaw 2026.4.25-beta 深度前瞻:TTS 全面重构、插件冷注册表、可观测性覆盖三大主线齐发

基于 v2026.4.25-beta.1 至 beta.4 四个预发布版本的 Release Notes 整理

概述

OpenClaw 2026.4.25-beta 是一次规模空前的预发布周期，从 beta.1 到 beta.4 累计包含数百项变更，涵盖六大核心领域：语音合成（TTS）生态全面升级、插件冷持久化注册表重构、可观测性（OpenTelemetry）全链路覆盖、浏览器自动化加固、控制面板与安装体验现代化，以及跨平台安装/更新健壮性提升。这是一个面向开发者和运维人员的大版本，标志着 OpenClaw 从”能用”向”企业级可维护”迈进的重要一步。

一、语音合成（TTS）生态全面升级

这是本次 beta 最引人注目的亮点。OpenClaw 对 TTS 进行了一次从底层到交互层的全面重构：

新增 TTS Provider 矩阵

Azure Speech：支持 Speech 资源认证、语音列表、SSML 转义、原生 Ogg/Opus 语音消息输出及电话语音输出
小米 MiMo TTS：新增小米 MiMo 语音合成 Provider，支持 MP3/WAV 输出和语音消息 Opus 转码
Inworld：支持流式 TTS 合成、语音列表、语音消息输出及 PCM 电话语音输出
Volcengine（火山引擎/字节 Seed Speech）：API Key 认证，原生 Ogg/Opus 和 MP3 输出
Local CLI TTS：本地命令行语音 Provider，支持文件/stdout 输入和 Opus 转码
ElevenLabs v3：将 eleven_v3 纳入内置 TTS 模型目录

交互层革新

/tts latest：一键朗读最新消息，支持重复抑制
/tts chat on|off|default：会话级自动 TTS 开关，按聊天粒度控制
/tts persona：Provider 感知的 TTS 人格系统，支持确定性 Provider 绑定合并，Google Gemini audio-profile-v1 和 OpenAI 指令映射
Per-agent/per-account 覆盖：agents.list[].tts 和 channels.<channel>.accounts.<id>.tts 支持深合并覆盖全局配置

跨渠道适配

WhatsApp：MP3/WebM 自动转码为 Ogg/Opus PTT 语音消息
飞书：语音消息转码为原生音频气泡，支持 Schema 2.0 卡片回调
BlueBubbles：iMessage 语音备忘录气泡投递
QQ Bot：原生语音消息合成
Discord：channels.discord.voice.model 支持语音频道 LLM 覆盖

二、插件冷持久化注册表（Cold Persisted Registry）

这是架构层面最重要的变更，彻底改变了插件启动和安装的路径：

核心变革

插件启动和安装路径迁移到冷持久化注册表，消除广泛的 manifest 扫描
openclaw plugins list 默认读取冷持久化注册表快照
openclaw plugins registry 命令提供显式注册表检查和 --refresh 修复
openclaw doctor --fix 自动刷新插件索引和冷注册表索引

性能影响

模型列表查询 models list --all --provider <id> 通过插件索引加载而非 manifest 扫描
Provider 发现从冷注册表解析，无需运行时抑制钩子
配置、频道、密钥、doctor、Provider 元数据路径均避免广泛扫描
插件命令别名验证基于冷 manifest 元数据，无需导入运行时

兼容性迁移

OPENCLAW_DISABLE_PERSISTED_PLUGIN_REGISTRY 标记为弃用的应急开关
自动迁移本地插件注册表、安装记录和 plugins.installs 配置
中央兼容性注册表扩展，包含所有者、替代品和最长三个月的移除时间表

三、OpenTelemetry 可观测性全链路覆盖

OpenTelemetry 覆盖范围扩展到几乎所有关键路径，且严格遵循低基数（bounded low-cardinality）原则：

覆盖范围

遥测领域	导出形式	隐私保护
模型调用	`model_call_started` /`model_call_ended` 钩子	不暴露 prompt、响应、headers
Token 使用	`gen_ai.client.token.usage` 直方图	不含 session 标识符
操作耗时	`gen_ai.client.operation.duration` 直方图	含有界 Provider/model 属性
工具循环	`openclaw.tool.loop` 计数器和 span	不含循环消息和参数
Harness 运行	`openclaw.harness.run` span + `openclaw.harness.duration_ms` 指标	共享 trace 形状
进程执行	`openclaw.exec` span	不暴露命令文本和工作目录
消息投递	有界投递 span	不含消息内容和收件人
上下文组装	`openclaw.context.assembled` span	含 prompt/history 尺寸，无内容
内存压力	有界内存直方图和计数器	不含 session 或 payload 数据

新增能力

信号级 OTLP 端点覆盖（traces/metrics/logs 独立配置）
W3C traceparent 头传播支持
Prometheus 诊断插件：带保护的 Gateway scrape 路由
语义约定稳定性选择：OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental

四、浏览器自动化加固

安全增强

Agent 响应中的安全标签 URL
CDP 原生 role 快照回退（iframe 感知引用、光标可点击检测）
CDP 连接就绪超时可配置（适配树莓派等慢速主机）
openclaw browser doctor --deep 实时快照探测
openclaw browser start --headless 一次性无头启动（不修改持久化配置）
远程和 attachOnly CDP HTTP/WebSocket 超时配置支持

下载管理

托管 Chrome 配置文件预置下载偏好
非托管点击触发的下载捕获到受保护目录

五、控制面板与安装体验现代化

Control UI

PWA 安装支持 + Web Push 通知（Gateway 聊天）
Crestodian 首次运行修复助手、TUI 设置、上下文模式选择器
更简洁的启动问候语
/usage 使用上下文快照计算百分比，包含缓存写入 token

安装/更新更强大

Windows：修复 C:\Program Files 路径截断、Lobster 嵌入式运行时、pnpm.exe 直接执行
macOS：Homebrew node@24 安装修复、fnm aliases PATH 支持
Linux：Ubuntu 24.04 无人值守安装、systemd 单元重启重试
Docker：patched dependency 文件复制、Bonjour/mDNS 桥接网络默认禁用
跨平台：LaunchAgent token 轮换、混合版本 Gateway 验证、磁盘空间低预警

六、 Provider 与集成更新

Provider 新增/修复

LiteLLM：注册为图像生成 Provider，支持 image_generate model=litellm/...
MiniMax：注册 minimax-portal 用于音乐和视频生成；TTS 支持 OAuth 和 Token Plan 认证；默认模型从 music-2.5+ 切换到 music-2.6
fal：新增 Seedance 2.0 参考到视频模型（多图/视频/音频参考输入）
Google Veo：修复视频 URI 直接下载、predictLongRunning REST 回退
OpenAI：gpt-image-1.5 透明背景、gpt-image-2 Codex Responses 后端
Ollama：Web Search 端点更新、https://ollama.com base URL 支持
Bedrock：延迟 AWS SDK 导入到实际运行时
Z.AI (GLM 5.x)：thinking 控制映射和 reasoning_content 保留
Venice：DeepSeek V4 Pro/Flash reasoning_content 占位符

集成更新

Codex Harness：要求 0.125.0+，覆盖原生 MCP PreToolUse/PostToolUse/PermissionRequest
Factory Droid：新增 ACP 绑定 Docker 矩阵
ACPX：acpx@0.6.1，不支持的通用模型覆写清晰失败
Google Meet：日历出勤导出工作流
飞书：流式卡片单轮单卡片、推理标签清理、话题线程流式卡片
Telegram：原生引用摘录、轮询挂起看门狗、webhook 中间件优先确认

七、Agent 与会话系统改进

子 Agent 完成结果通过直接回退投递到无线程请求路由
sessions_spawn 支持 runTimeoutSeconds 对 ACP 子回合应用超时
会话重置分离新鲜度与 updatedAt，心跳/定时/执行不再阻止日/空闲滚动
活跃记忆召回子 Agent 的计费/认证故障不再影响共享认证配置冷却状态
Claude CLI 支持 1M 上下文窗口覆写（context1m 启用时）
Codex 路径：原生 Codex app-server 优先于 ACP，除非显式指定

从 beta.1 到 beta.4 的增量修复

四个 beta 版本的 Highlights 和 Changes 保持一致（累积发布），差异主要集中在 Fixes 部分的增量修复：

beta.2+：新增 openclaw channels add 标志驱动安装（stdin 关闭自动化场景下的 Telegram 设置修复）
beta.3 和 beta.4：持续修复插件卸载/安装路径、CDP 会话重连、ACP 绑定超时、流式助手回复空文本恢复等问题
整体修复数量逐版递增，体现了 beta 周期快速迭代、密集修复的特征

免责声明

本文内容整理自 OpenClaw 官方 GitHub Release Notes，具体来源如下：

https://github.com/openclaw/openclaw/releases/tag/v2026.4.25-beta.1
https://github.com/openclaw/openclaw/releases/tag/v2026.4.25-beta.2
https://github.com/openclaw/openclaw/releases/tag/v2026.4.25-beta.3
https://github.com/openclaw/openclaw/releases/tag/v2026.4.25-beta.4

上述链接均为预发布版本（beta），具体功能特性、API 接口和行为以 OpenClaw 正式发布的稳定版本为准。