夜雨聆风
OpenClaw 2026.4.26 深度解析:迁移工具、语音中继与插件治理
OpenClaw 2026.4.26 深度解析：迁移工具、语音中继与插件治理
14 个核心更新 + 50+ 修复，从 beta.1 到正式版全量解读
我是atyou, 今天教大家OpenClaw 2026.4.26 Release 核心功能深度解读。
OpenClaw 2026.4.26 正式版于 2026 年 4 月 28 日发布，这是继 4.25 大版本之后的又一次重要迭代。beta.1 版本于 4 月 27 日发布，正式版仅一天后就完成合并上线。
本次更新带来了两大迁移工具（Claude Importer 和 Hermes Importer），标志着 OpenClaw 正式成为 AI Agent 领域的跨平台迁移枢纽。同时新增 Cerebras 提供商、浏览器实时语音中继、以及大量插件治理和 Memory 系统改进。
本文将从新功能、架构改进和 Bug 修复三个维度，逐一解读这个版本的每一项变更。
— — — — — — — — — —
一、CLI 迁移工具：从 Claude 和 Hermes 一键导入
本次最重磅的功能之一，新增两个完整的迁移工具，帮助用户从 Claude Code/Desktop 和 Hermes Agent 无缝切换到 OpenClaw。
Step 1Claude Importer
新增捆绑的 Claude 导入器，可以预览和应用以下配置：Claude Code 和 Claude Desktop 的自定义指令、MCP 服务器列表、Skills 技能包、命令提示词，以及安全归档/人工审核状态。
这意味着 Claude 用户可以在几分钟内将完整的开发环境配置迁移到 OpenClaw，包括所有自定义的 Agent 行为和工具链。
# 预览 Claude 配置迁移
openclaw migrate –source claude –dry-run
# 执行迁移
openclaw migrate –source claude
|
⚠️踩坑 迁移前会自动创建 pre-migration backup，但如果之前有自定义 MCP 服务器指向本地服务，需要手动检查端口和路径是否正确 |
Step 2Hermes Importer 与 openclaw migrate 命令
新增 openclaw migrate 命令，支持 plan、dry-run、JSON 输出、pre-migration backup、onboarding detection 等完整流程。
捆绑 Hermes 导入器，支持导入：Hermes Agent 的完整配置、memory/plugin hints、模型提供商设置、MCP 服务器、Skills 技能、以及支持的凭据信息。
archive-only report copies 功能允许在迁移时保留一份只读的迁移报告副本，便于回溯。
# 迁移前预览（Plan 模式）
openclaw migrate –source hermes –plan
# 生成 JSON 格式的迁移报告
openclaw migrate –source hermes –json > migration-report.json
— — — — — — — — — —
二、浏览器实时语音中继与 Talk 增强
Control UI/Talk 模块迎来重大更新，新增浏览器实时传输协议、Google Live 浏览器会话和 Gateway 语音中继。
Step 1浏览器实时传输合约
新增通用的浏览器实时传输合约（realtime transport contract），为 WebRTC 和 WebSocket 两种传输方式提供统一的抽象层。
Google Live 浏览器 Talk 会话支持受限的临时令牌（constrained ephemeral tokens），用户无需长期暴露 API 凭据即可使用语音功能。
Gateway relay 用于后端实时语音插件的中继转发，实现纯后端部署的语音 Agent 架构。
Step 2Talk 修复与改进
保持 Google Live 浏览器会话使用 WebSocket 传输而非降级到 WebRTC，避免不必要的协议切换。
验证浏览器端 Google Live WebSocket 端点，防止无效连接。
每个浏览器连接限制 Gateway relay 会话数，防止单个连接消耗过多资源。
移除不使用配置 Talk/TTS 提供商的旧版浏览器原生语音按钮。
|
📌提示 如果你使用 Google Live 语音，确保 Gateway 配置了正确的 TTS provider，否则浏览器会话可能无法正常工作 |
— — — — — — — — — —
三、新增 Cerebras 提供商
Cerebras 作为新的捆绑插件加入 OpenClaw，提供超低延迟的推理服务。
Step 1Cerebras 插件集成
Cerebras 现已作为捆绑插件（bundled plugin）集成到 OpenClaw，无需额外安装。
包含完整的 onboarding 引导流程、静态模型目录、官方文档链接和 manifest 管理的端点元数据。
Cerebras 以其 wafer-scale 芯片技术著称，推理速度极快，适合对延迟敏感的实时 Agent 场景。
# 查看可用模型
openclaw models list –provider cerebras
# 配置 Cerebras API Key
openclaw provider setup cerebras
— — — — — — — — — —
四、Memory 与向量搜索增强
Memory 系统获得多项改进，包括非对称嵌入、Ollama 模型特定前缀、以及大量 QMD 修复。
Step 1非对称嵌入端点支持
新增可选的 memorySearch.inputType、queryInputType 和 documentInputType 配置，支持非对称嵌入端点。
支持直接查询嵌入和提供商批量索引，让不同模型可以使用不同的嵌入策略来优化检索质量。
此功能由社区贡献者 HOYALIM 和 prospect1314521 推动完成。
Step 2Ollama 模型特定检索前缀
为 nomic-embed-text、qwen3-embedding 和 mxbai-embed-large 三个 Ollama 嵌入模型添加模型特定的检索查询前缀。
文档批处理保持不变，仅对查询端添加前缀，确保检索时语义匹配更精准。
Step 3QMD 修复合集
同源集合合并为单次 QMD 搜索调用，减少重复搜索开销（需要新版 QMD 支持多 -c 过滤）。
兼容 QMD 状态向量计数变体格式（Vectors = 42 / Vectors:42 / Vectors: 42 embedded），不再误报嵌入不可用。
BM25-only（lexical searchMode）模式下跳过向量状态探测和嵌入维护，避免 ARM 设备上触发 llama.cpp/Vulkan 构建。
报告 QMD 实时监视器脏状态，修改过的文件会显示为 dirty 直到同步完成。
|
⚠️踩坑 ARM 设备（如 Raspberry Pi）使用 QMD 时，如果设置 searchMode: ‘search’（纯 BM25），不要忘记跳过向量相关配置，否则会触发不必要的编译 |
— — — — — — — — — —
五、插件系统治理与优化
插件系统在安装、发现、配置和启动等多个环节获得重要改进。
Step 1插件配置架构升级
废弃直接插件配置加载/写入辅助函数，改用传递运行时快照 + 事务性变更辅助函数，附带显式重启策略、扫描器防护和基于修订版本的缓存失效。
插件/provider 路由表从核心模块迁移到插件 manifest 中，核心不再携带捆绑提供商路由表。
OPENCLAW_PLUGIN_STAGE_DIR 支持分层运行时依赖根目录，解析只读预安装依赖后再安装缺失依赖到可写根目录。
Step 2插件安装修复
安装安全扫描时跳过测试文件和目录（但仍强制扫描声明的运行时入口点），解决打包的测试 mock 阻塞插件安装的问题。
允许指向可信 OpenClaw 宿主包的精确包管理器对等链接，同时继续阻止欺骗性或嵌套逃逸的 node_modules 符号链接。
从活动配置文件状态目录解析插件安装目标，确保 –profile 指定的配置不再写入默认配置文件。
Step 3插件发现与启动优化
跟随符号链接的插件目录（全局和工作区根目录），同时忽略损坏的链接并保留现有安全检查。
在整个插件发现过程中复用规范 realpath 查找，Windows npm-global 启动不再重复昂贵的路径解析。
重复插件启动警告被抑制，npm 安装的插件有意覆盖同名捆绑插件时不再报错。
|
📌提示 如果你用 npm 全局安装了一个与捆绑插件同名的插件，可以用 openclaw doctor –fix 检查状态，新版不会误报 |
— — — — — — — — — —
六、Control UI 与 Gateway 改进
控制面板新增配置差异面板，Gateway 在稳定性和安全性方面获得多项修复。
Step 1原始配置差异面板
新增 raw config pending-changes diff 面板，解析 JSON5 格式配置，敏感值在用户手动揭示前自动脱敏。
打开面板时避免触发虚假的 raw-edit 回调，解决 [#39831]、[#48621] 和 [#46654] 的历史问题。
Step 2Dashboard 布局优化
Quick settings dashboard grid 在桌面、平板和移动端布局中实现卡片对齐，不再浪费水平空间。
Step 3Gateway 关键修复
停止从共享/管理员 device.token.rotate 响应中回显轮换后的 bearer token，修复令牌泄露风险（[#66773]）。
前台 Gateway 运行跳过 CLI 自重启，低内存 Linux/Node 24 主机不再在日志前挂起（[#72720]）。
将未捕获的 EPIPE 断管流错误视为非致命错误，Discord 投递或关闭管道不再崩溃 Gateway。
Docker slim 镜像安装 CA 证书包，容器化 Gateway HTTPS 调用不再因 TLS 设置失败（[#72787]）。
|
🔴安全警告 如果你之前使用了 device.token.rotate API，建议立即升级到此版本，旧版本可能在响应中暴露 bearer token |
— — — — — — — — — —
七、Agent 与 Compaction 改进
Agent 系统新增自动压缩触发器，子 Agent 管理获得多项安全性修复。
Step 1Transcript 自动压缩
新增 opt-in 配置 agents.defaults.compaction.maxActiveTranscriptBytes，当活动 JSONL 文件超过阈值时自动触发本地压缩。
压缩成功后将后续对话轮次写入更小的后继文件，而非原始字节分割历史，避免压缩后体积不降的问题。
# 在 config 中启用自动压缩
agents:
defaults:
compaction:
maxActiveTranscriptBytes:5242880# 5MB
Step 2子 Agent 安全修复
sessions_spawn(agentId=…) 显式调用时强制执行 subagents.allowAgents 规则，不再自动允许请求者自指向（[#72827]）。
sessions_spawn(runtime=’acp’) 引导轮次允许在 acp.dispatch.enabled=false 时运行，但自动 ACP 线程调度仍被阻止（[#63591]）。
子 Agent 绑定到不同通道账户时保留请求者投递，同通道线程完成仍路由到子线程。
完成投递缺少请求者会话信号时，采用 fail-closed 策略而非选择单个子线程绑定。
Step 3工具循环检测与 Fallback
工具循环检测历史范围限定为当前运行，计划心跳周期不再继承上一次运行的过时重复调用计数（[#40144]）。
忽略 exec 运行时元数据的易失部分进行比较，启用循环检测可以停止重复的相同 shell 命令结果（[#34574]）。
模糊的提供商失败细分为 empty_response、no_error_details 和 unclassified，结构化 fallback 日志添加扁平 fallback-step 字段（[#71922]）。
— — — — — — — — — —
八、平台与提供商兼容性
多个提供商获得兼容性修复，Windows 平台问题全面解决，代理配置更加灵活。
Step 1提供商修复
Groq 和 LM Studio 支持声明提供商原生推理力度值，Qwen thinking 模型接收 none/default 或 off/on 而非 OpenAI-only 的 low/medium（[#32638]）。
仅配置 baseUrl 的自定义提供商默认使用 Chat Completions 适配器，本地 OpenAI 兼容代理不再超时（[#40024]）。
移除已退役的 OpenRouter Hunter Alpha 和 Healer Alpha 静态目录行，禁用过时 Hunter Alpha 配置的代理推理注入（[#43942]）。
LiteLLM 在非交互式 API-key onboarding 中遵循 –custom-base-url，不再添加代理发现副作用。
Step 2Windows 平台修复
Feishu/Lark 消息发送不再因 c: ESM loader URL 失败，捆绑通道 sidecar 加载前规范化路径（[#72783]）。
捆绑插件模块传给 Jiti 前规范化 Windows 绝对路径，解决 ESM 加载器不支持的 c: 路径格式。
Step 3代理与环境配置
ALL_PROXY / all_proxy 环境变量传入全局 Undici 环境代理分发器和提供商代理抓取辅助函数（[#43821]）。
SSRF 受信代理自动升级仅在 HTTP_PROXY / HTTPS_PROXY 上生效，确保安全性不被削弱。
Google Meet 通过浏览器控制授权媒体权限，固定本地 Chrome 音频默认为 BlackHole 2ch，解决 Permission needed 问题。
— — — — — — — — — —
九、其他重要修复与改进
Matrix 加密、Discord、Nodes 管理、Compaction 等模块均获得重要修复。
Step 1Matrix 端到端加密
新增 openclaw matrix encryption setup 命令，一条命令完成 Matrix 加密启用、恢复引导和验证状态打印。
openclaw matrix encryption setup
Step 2Discord 与消息通道
隐藏 /model 调度成功但线程会话存储仍然过时时，持久化路由的模型选择器覆盖。
线程会话继承父通道的会话级 /model 覆盖作为模型备用，但不启用父 transcript 继承（[#72755]）。
Discord/Slack/Mattermost 消息工具暴露 user:/channel: 目标语法和 Discord 歧义错误（[#72401]）。
Step 3节点管理与 CLI
新增 openclaw nodes remove –node和 node.pair.remove，清理过期的网关节点配对记录。
CLI update 安装 npm 全局更新到验证的临时前缀后再交换包树，防止新旧混合安装（[#72775]）。
tasks –json 路由通过精简 JSON 路径，只读任务检查不再加载无关插件/运行时命令图（[#66238]）。
Step 4压缩与上下文管理
跳过过大的预压缩检查点快照，从压缩输入和轮换后继 transcript 中修剪重复的长用户轮次，防止重试风暴被保存到检查点周期（[#72780]）。
压缩后 Token 估算从自动压缩持久化，即使提供商省略使用元数据，/status 和会话列表仍显示最新的上下文使用量（[#67667]）。
— — — — — — — — — —
七、常见问题与排错
如何从 Claude Code 迁移到 OpenClaw？
运行 openclaw migrate –source claude –dry-run 预览迁移内容，确认后去掉 –dry-run 执行迁移。迁移会自动备份现有配置。
Cerebras 提供商如何使用？
Cerebras 已作为捆绑插件集成，运行 openclaw provider setup cerebras 配置 API Key 后即可在模型列表中选择 Cerebras 模型。
maxActiveTranscriptBytes 怎么配置？
在 config 中设置 agents.defaults.compaction.maxActiveTranscriptBytes，建议值 5MB（5242880 字节），超过时自动触发压缩。
Docker slim 镜像 HTTPS 失败怎么办？
升级到此版本即可解决，新版在 slim 镜像中预装了 CA 证书包。如使用旧版，需手动安装 ca-certificates。
Gateway relay 语音中继是什么？
Gateway relay 允许后端部署的实时语音插件通过 Gateway 中继转发音频流，实现纯后端架构的语音 Agent，无需浏览器端暴露 API Key。
插件安装安全扫描误报怎么处理？
新版已跳过测试文件扫描但仍强制扫描运行时入口点。如仍有问题，运行 openclaw doctor –fix 检查。
如何查看迁移报告？
运行 openclaw migrate –source
ALL_PROXY 环境变量现在生效了吗？
是的，此版本修复了代理配置问题，ALL_PROXY 和 all_proxy 现在会被 Gateway 和提供商请求正确使用。
— — — — — — — — — —
八、安全建议
•Device token rotate 不再在响应中回显 bearer token，修复令牌泄露风险
•Matrix 加密设置命令提供一键式端到端加密启用
•插件安装安全扫描保留运行时入口点强制扫描
•SSRF 受信代理升级仅在 HTTP/HTTPS_PROXY 生效，ALL_PROXY 不降低安全等级
•推理标签在输出端作为隐私边界处理，防止本地模型泄露思维链文本
•ACP 引导轮次允许但自动调度仍被阻止，防止意外触发
|
⚠️重要提醒 本文中出现的所有 Token 均为示例或已脱敏处理。请务必使用你自己的 Token，并妥善保管。切勿将敏感凭证提交到 Git 仓库。 |
— — — — — — — — — —
总结
CLI 迁移工具：Claude Importer + Hermes Importer，一键迁移完整配置
浏览器实时语音：Google Live WebSocket + Gateway relay 中继架构
Cerebras 提供商：超低延迟推理服务捆绑集成
Memory 增强：非对称嵌入 + Ollama 模型前缀 + QMD 修复
插件治理：配置事务化 + 安装安全扫描优化 + 发现性能提升
安全修复：Device token 不再回显 + Windows ESM 路径修复
Agent 改进：自动压缩触发 + 子 Agent 安全策略 + 循环检测
•迁移工具🔄 Claude + Hermes 一键导入
•语音中继🎙️ Google Live + Gateway Relay
•新提供商⚡ Cerebras 捆绑插件
•Memory🧠 非对称嵌入 + Ollama 前缀
•插件治理🔧 配置事务化 + 安全扫描
•平台支持💻 Win/Mac/Linux/Docker 修复
•安全修复🔒 Token 回显 + Windows 路径
•贡献者👥 80+ 社区贡献者
— — — — — — — — — —
我是atyou, 您有什么感兴趣的主题，可以给我留言让我们一起拥抱AI, 共同进步，享受美好生活。
参考文档：
•OpenClaw 仓库 → 点击访问
https://github.com/openclaw/openclaw
•v2026.4.26 正式版 → 点击访问
https://github.com/openclaw/openclaw/releases/tag/v2026.4.26
•v2026.4.26-beta.1 → 点击访问
https://github.com/openclaw/openclaw/releases/tag/v2026.4.26-beta.1
•Cerebras 官网 → 点击访问
https://cerebras.ai/
•OpenTelemetry 文档 → 点击访问
https://opentelemetry.io/docs/