OpenClaw 2026.4.26 发布——Control UI Talk 实时语音 + Cerebras 提供商 + 配置迁移工具

发布时间：2026-04-28 分类： 当前热点

发布时间： 2026年4月28日 01:11
版本号： 2026.4.26（Latest 最新版）

更新内容总结： 4 月下旬最新版本，引入 Control UI 通用浏览器实时语音传输、Cerebras 捆绑插件、记忆搜索非对称嵌入端点支持、以及 Claude/Hermes 配置迁移工具。同时包含大量插件系统重构、代理子代理权限加固、以及 Windows 平台兼容性修复。

✨ 新功能

1. Control UI Talk 实时语音传输

引入通用浏览器实时传输协议，支持：

  • Google Live 浏览器 Talk 会话：使用受限临时令牌
  • Gateway 中继：支持仅后端实时语音插件
  • 替代原有的 WebRTC 回退方案，提升稳定性

2. Cerebras 提供商插件

新增捆绑的 Cerebras 提供商插件，包含：

  • Onboarding 引导流程
  • 静态模型目录
  • 文档和 manifest 拥有的端点元数据

3. 记忆搜索非对称嵌入支持

新增可选配置项，支持非对称嵌入端点：

  • memorySearch.inputType、queryInputType、documentInputType
  • 支持直接查询嵌入和提供商批量索引
  • 适用于需要不同查询/文档嵌入模型的场景

4. Ollama 记忆检索前缀

为以下模型添加模型特定的检索查询前缀：

  • nomic-embed-text
  • qwen3-embedding
  • mxbai-embed-large
    文档批次保持不变，仅优化查询侧嵌入。

5. 插件系统重构

  • 配置加载迁移：弃用直接插件配置加载/写入辅助函数，改用传递的运行时快照 + 事务性变更辅助函数
  • 重启策略：明确的重启后续策略
  • 扫描保护：扫描器防护栏、运行时警告、基于修订版本的缓存失效

6. 插件安装分层依赖

支持 OPENCLAW_PLUGIN_STAGE_DIR 包含分层运行时依赖根目录，在安装缺失依赖前先解析只读预安装依赖。

7. Control UI 配置差异面板

新增原始配置待更改差异面板：

  • 解析 JSON5
  • 默认隐藏敏感值，支持手动揭示
  • 避免打开面板时触发虚假的原始编辑回调

8. Control UI 快速设置仪表盘优化

润色快速设置仪表盘网格，使常用卡片在桌面、平板和移动布局中对齐，不浪费水平空间。

9. Matrix E2EE 支持

新增 openclaw matrix encryption setup 命令，一站式启用 Matrix 加密、引导恢复和打印验证状态。

10. 代理压缩主动触发

新增可选 agents.defaults.compaction.maxActiveTranscriptBytes 预检触发器：

  • 当活跃 JSONL 文件过大时运行正常本地压缩
  • 需要转录轮换，成功压缩后将未来轮次移至较小的后续文件，而非原始字节拆分历史

11. CLI 配置迁移工具

Two new migration tools:

Claude 导入器

预览并应用 Claude Code 和 Claude Desktop 的：

  • 指令配置
  • MCP 服务器
  • Skills
  • 命令提示词
  • 安全归档/手动审核状态

Hermes 导入器

支持配置、记忆/插件提示、模型提供商、MCP 服务器、Skills 和受支持凭据的迁移。

🐛 修复内容

挺多的。。。

⚠️ 升级注意事项与常见问题

从 4.22 升级必读

1. Control UI Talk 传输变更

影响：使用 Google Live Talk 的用户
变更：从 WebRTC 回退切换到 WebSocket 传输
操作：验证浏览器 Google Live WebSocket 端点配置；移除陈旧浏览器原生语音按钮
潜在问题：如果之前依赖 WebRTC，需要检查配置是否兼容新传输协议

2. 插件配置加载方式变更

影响：有自定义插件配置的用户
变更：弃用直接插件配置加载/写入辅助函数，改用运行时快照 + 事务性变更
操作：运行 openclaw doctor --fix 迁移配置
潜在问题：旧的配置加载方式可能不兼容，需要验证插件是否正常加载

3. 子代理权限加固

影响：使用 sessions_spawn(agentId=...) 的用户
变更：现在强制执行 subagents.allowAgents，不再自动允许请求者自身目标
操作：检查 subagents.allowAgents 配置，确保需要的代理已被明确允许
潜在问题：之前能正常工作的同代理 spawn 调用可能因权限问题失败

4. ACP 会话生成行为变更

影响：使用 sessions_spawn(runtime="acp") 的用户
变更：显式 ACP spawn 现在可以引导轮次运行，即使 acp.dispatch.enabled=false
操作：检查是否有依赖 acp.dispatch.enabled=false 来阻止 ACP 的脚本
潜在问题：配置可能意外启动 ACP 线程

5. Windows 插件路径规范化

影响：Windows 用户，特别是使用 Feishu/Lark 插件
修复：规范化 Windows 绝对路径，防止 c: ESM 加载器 URL 错误
操作：升级后测试 Feishu/Lark 消息发送功能
潜在问题：如果之前有手动路径配置，可能需要清理

6. Docker TLS 证书缺失

影响：使用 Docker 容器化网关的用户
修复：在 slim 镜像中安装 CA 证书包
操作：重新拉取最新镜像并重启容器
潜在问题：如果之前通过挂载方式解决 TLS 问题，可能需要调整挂载配置

7. Memory QMD 搜索行为变更

影响：使用 QMD 记忆搜索的用户
变更：同源集合现在分组到单个 QMD 搜索调用（如果 QMD 支持）
操作：运行 memory status --deep 验证向量计数是否正常
潜在问题：旧版 QMD 构建可能不支持新的分组调用，会自动回退到每集合调用

8. Ollama WSL2 GPU 崩溃循环警告

影响：在 WSL2 中使用 GPU 加速 Ollama 的用户
新增警告：检测到 GPU + Restart=always 组合时会发出警告
操作：检查 systemd、.wslconfig 和 keep-alive 配置
潜在问题：可能需要调整配置防止 Ollama 崩溃循环

9. MCP 服务器配置自动迁移

影响：使用 type: "http" MCP 服务器的用户
变更：配置自动规范化为 transport: "streamable-http"
操作：运行 openclaw doctor 检查是否需要修复
潜在问题：嵌入式 Pi 可能对这些服务器回退到传统 SSE，需要验证

10. 代理工具循环检测改进

影响：使用 exec 工具且可能触发循环检测的用户
变更：忽略易失性运行时元数据（持续时间、PID、会话、cwd），仅比较工具循环结果
操作：如果之前因元数据变化导致循环检测重置，现在应该能正确检测
潜在问题：可能需要调整循环检测阈值

插件兼容性检查

升级前建议运行：

openclaw compatibility check
openclaw doctor --fix --auto-approve

扫描所有已安装插件，检查是否已迁移至 openclaw/plugin-sdk/*，并自动修复常见配置问题。

完整备份

升级前务必备份：

# 备份配置目录
cp -r ~/.openclaw ~/.openclaw_backup_$(date +%Y%m%d)

# 备份数据库
openclaw database backup --full

# 如果使用 Docker
docker cp <container_id>:/app/data ./openclaw_data_backup

升级命令

# 停止服务
openclaw service stop

# 更新核心
npm install -g openclaw@2026.4.26

# 运行迁移（重要！）
openclaw doctor --fix --auto-approve

# 更新插件
openclaw plugins update --all

# 如果有 Claude 或 Hermes 配置需要迁移
openclaw migrate --help
openclaw migrate claude --dry-run  # 先预览
openclaw migrate claude            # 执行迁移

# 启动并验证
openclaw service start
openclaw status --verbose

# 验证 Control UI Talk（如果使用）
openclaw control-ui status

回滚方案

如果升级后出现问题：

# 停止新版本
openclaw service stop

# 恢复备份
rm -rf ~/.openclaw
mv ~/.openclaw_backup_$(date +%Y%m%d) ~/.openclaw

# 重新安装旧版本
npm install -g openclaw@2026.4.22

# 启动旧版本
openclaw service start

点评

🎯 实时语音 + 插件生态成熟化。v2026.4.26 在 4.22 基础上进一步巩固了 OpenClaw 的企业级能力。

三个最值得关注的更新：

  1. Control UI Talk 实时语音架构升级——从 WebRTC 切换到 WebSocket 传输，配合 Gateway 中继，为浏览器端实时语音交互提供了更稳定的基础设施。Google Live 用户将获得更一致的体验。
  2. 配置迁移工具链完善——新增 Claude 和 Hermes 配置迁移工具，标志着 OpenClaw 正在构建完整的生态迁移路径。对于从其他 AI 编程工具迁移过来的用户，这大幅降低了切换成本。
  3. 插件系统健壮性提升——配置加载方式重构、子代理权限加固、Windows 路径规范化修复，显示出项目对生产环境稳定性的重视。

需要警惕的升级风险：

风险点严重程度影响范围
插件配置加载方式变更⚠️ 中等自定义插件用户
子代理权限加固⚠️ 中等使用 sessions_spawn 的用户
Windows 插件路径规范化✅ 已修复Windows + Feishu/Lark 用户
Docker TLS 证书缺失✅ 已修复Docker 容器用户

升级建议：

生产环境：先在测试环境验证，特别关注：

  • 插件配置是否需要迁移（运行 openclaw doctor --fix）
  • 子代理权限配置（检查 subagents.allowAgents）
  • Control UI Talk 配置（如果使用 Google Live）

开发环境：可以直接升级，新功能（Cerebras 支持、记忆搜索优化）值得尝试。

从 4.22 升级的特殊说明：这是一次”插件架构过渡”版本，虽然不包含 Breaking Changes，但配置加载方式的重构意味着内部行为的改变。建议仔细阅读升级日志，并准备好回滚方案。

总体而言，v2026.4.26 是一个稳定性和生态完善版本，为接下来的功能爆发期打下坚实基础。特别是配置迁移工具的加入，暗示 OpenClaw 正在加速生态整合。

毒舌点评：
这版本号跳得挺快，4.22 才发布 5 天就憋出个 4.26。不过看内容倒不是凑数的——Control UI Talk 的 WebSocket 改造、插件系统重构、配置迁移工具链，都是在给后面的功能爆发打地基。

特别要注意那个插件配置加载方式变更，虽然官方说”无 Breaking Changes”，但内部行为的改变还是挺折腾人的。建议生产环境先在测试环境跑一遍，别直接裸奔升级。

顺便说一句，那个 Claude/Hermes 迁移工具 意味深长——看来 OpenClaw 要开始抢其他 AI 编程工具的用户了。