OpenClaw v2026.5.20-beta.1 安全更新:let voice sessions follow co…

OpenClaw 刚发布了 v2026.5.20-beta.1，这是一个预发布版本。这次更新不是单点小修，而是把 let voice sessions follow configured Discord users into voice channels 放到了更前面，同时又补了一批稳定性和边界能力。如果你已经在比较认真地使用 OpenClaw，这版很值得尽快看一遍。

1. let voice sessions follow configured Discord users into voice channels

这是本次更新最核心的一项变化，已经能明显看出 OpenClaw 在长期运行和能力沉淀上的推进。

2. Discord/voice

这项变化更偏可视化和可管理性，能提升你在真实使用中的可控感。

3. Dependencies

这一部分更偏稳定性或安全边界补强，虽然不一定最显眼，但价值很高。

4. add the bundled Policy plugin for policy-backed channel conformance checks

这部分属于补强型更新，和主变化一起看，更容易理解这版为什么值得升级。

5. Agents/config

这部分属于补强型更新，和主变化一起看，更容易理解这版为什么值得升级。

这次更新主要集中在哪些方向

• Control UI
• 安全与执行
• 移动端与桌面端

适合谁尽快了解

适合正在重度使用 OpenClaw、关注长期记忆体系、控制台管理能力与真实环境稳定性的用户尽快了解。

你可以先重点留意的关键词

• Control UI
• 安全与执行

中文整理稿

openclaw v2026.5.20-beta.1

类型： 预发布版本 发布： 2026-05-21 官方发布： https://github.com/openclaw/openclaw/releases/tag/v2026.5.20-beta.1

新增功能

• Discord 语音会话增强： 支持语音会话跟随已配置的 Discord 用户进入语音频道，包含允许频道校验、多用户切换、有界协调（bounded reconciliation）以及 DAVE 恢复保护。
• Discord 语音上下文注入： 默认在实时语音会话指令中注入有界的 IDENTITY.md、USER.md 和 SOUL.md 配置文件上下文；可通过 voice.realtime.bootstrapContextFiles: [] 禁用。
• Codex 依赖更新： 内置 Codex 工具链升级至 @openai/codex 0.132.0，同步更新 app-server 模型列表文档。
• Policy 插件（Beta）： 新增官方 Policy 插件，支持基于策略的渠道合规检查、doctor 诊断建议以及可选的工作区修复功能。
• Agent 级本地模型精简开关： 允许在单个已配置 Agent 上启用 experimental.localModelLean，无需全局开启。
• xAI 设备码 OAuth 登录： 新增 xAI 设备码 OAuth 授权方式，远程及无头（headless）环境可直接完成授权，无需本地浏览器回调。
• OpenRouter Provider 级路由策略： OpenRouter 请求现在遵循 Provider 级别的 params.provider 路由策略，模型参数和 Agent 参数可覆盖默认配置。

问题修复

渠道与消息

• WhatsApp： 升级 Baileys 至 7.0.0-rc12。
• WhatsApp： 优化出站消息.pending状态的30秒定时释放机制，在 Provider 已连接时新排队的消息无需等待下一次重连即可发送。
• WhatsApp： 优化未注册群组的入站诊断信息，指向 channels.whatsapp.groups 配置项。
• Mattermost： 修复缺少 channel type 时错误开放（fail open）的问题。
• Discord： 保留禁用状态的 presentation 按钮，在渲染 Discord 消息控制组件时正确适配。
• Matrix： 支持 messages.queue.byChannel.matrix 队列覆盖配置，队列 Provider 的 schema/type 键位与 Matrix、Google Chat、Mattermost 对齐。

Agent 与会话

• Agent/消息： 修复 message 工具独立回合在成功发送后错误停止的问题，同时保留 session 写锁下的 transcript 镜像。
• Agent/心跳： 将静默心跳响应工具从 transcript 快照中过滤，避免后续用户回合被无意义消息污染。
• Agent/子 Agent： 修复过期完成通知的恢复机制，支持无 transcript 等待的重试及强制消息工具切换。
• Agent/子 Agent： 修复通配符子 Agent 目标允许列表的范围约束，仅限于已配置的 Agent。
• Agent/子 Agent： 跳过休眠完成请求者的过期嵌入式运行唤醒探测，避免 reason=no_active_run 队列噪音。
• Agent/Codex： 保留加密 Responses reasoning 回放的 provenance 绑定，过期镜像在请求组装前丢弃无效加密内容。
• Agent/超时： 显式 models.providers.<id>.timeoutSeconds 值现在优先于默认空闲看门狗时长，长首 token 等待不再在 ~120s 错误回退。
• Agent/suppressToolErrors： messages.suppressToolErrors 现对工具失败 mutating 错误生效，配置的聊天界面不再收到独立警告。
• Agent/降级提示： 混合 rate-limit 加账单降级耗尽场景现在显示具体账单指引，不再使用通用失败文案。
• Agent/OpenAI： 严格工具 schema 降级的重复诊断信息现在按 provider/model/工具签名去重，减少日志噪音同时保留 strict=false 回退行为。

CLI 与命令行

• CLI/QA 子命令： 私用 QA 子命令默认不再出现在导出命令描述符中，除非设置 OPENCLAW_ENABLE_PRIVATE_QA_CLI=1，修复 root help 和子命令标记与运行时注册不一致的问题。
• CLI/cron show： 修复 openclaw cron show 任务查找分页，防止 cron.list 无响应时命令挂起。
• CLI/message： openclaw message --json 输出现包含稳定的顶层 messageId。
• CLI/acp client： 格式化 openclaw acp client 错误通过统一错误格式化器，对象形错误不再打印 [object Object]。
• CLI/channels logs： 修复滚动尾窗口精确落在行边界时首行输出丢失的问题。
• CLI/内联选项值： 保留内联根选项值中的嵌入式等号，不再在第二个分隔符处截断。
• CLI/config 读取重试： 修复配置快照读取瞬时失败后不重试的问题，避免同一进程中后续命令受影响。
• CLI/nodes approve： openclaw nodes approve 前先请求待处理节点 surface approval scopes，解决 missing scope: operator.admin 错误。
• CLI/TUI： 自动补全现包含 Gateway 插件斜杠命令。

Cron 与调度

• Cron/主会话阻塞： 修复主会话定时任务在后台 cron 线程中阻塞人类主会话聊天的问题，定时工作现在运行在 cron 自有的 wake lane 上同时保留回复投递上下文。
• Cron/嵌入式拒绝元数据： 隔离定时任务使用结构化嵌入式运行拒绝元数据，被阻止的 exec 请求正确使任务失败，不再将普通 assistant 文案误判为拒绝。
• Cron/恢复诊断： 成功定时任务的恢复工具警告现在保留为诊断信息，最终 cron 输出正确投递，不再被后处理警告覆盖。
• Cron/遗留 jobs.json： 修复加载或添加定时任务时将遗留顶层数组 jobs.json 存储当作空存储处理的问题。
• Cron/最终输出： 修复日程任务成功但末尾仍有普通工具警告时，最终 assistant 输出优先正确投递而非标记失败。

控制台与 UI

• Control UI/终端： 终端会话状态现在优先于过期的 active-run 标记，修复已完成终端运行仍显示 abort/live UI 的问题。
• Control UI/使用量面板： 使用量面板中过长的上下文 skill、工具和文件名现在截断显示，悬停可查看完整名称。
• Status 面板： 当会话停留在与 agents.defaults.model.primary 不同的模型上时，Status 现显示所配置默认值、会话选定模型、原因、清除提示和文档链接。

桌面端与移动端

• macOS 应用签名： 修复本地打包使用稳定应用身份签名的问题，支持权限测试；同步修复 Control UI 生产构建在当前 Vite/Highlight.js 导出下的构建问题。
• macOS Peekaboo： 嵌入式 Peekaboo bridge 升级至 3.2.1，适配当前 Peekaboo CLI 捕获流程。
• iOS TestFlight： 修复 Release archive 在 TestFlight 构建中的编译问题。
• Windows 安装器： install.ps1 onboarding 现以 attached 子进程方式启动，修复原生 Windows 安装时在 Starting setup... 卡住或终端渲染损坏的问题。
• Gateway/移动端： 恢复 iOS 和 Android onboarding 中 bounded operator token 的 QR setup-code 交接，同时将 admin 和 pairing scopes 排除在 bootstrap 之外。

依赖与其他

• fs-safe 依赖： @openclaw/fs-safe 升级至 0.2.7，在 Linux/macOS 上默认关闭 Python-helper 策略下保留私有存储、密钥写入、运行日志和媒体附件的最佳 effort Node 写回退。
• 浏览器截图大小限制： 浏览器截图和带标签快照现在遵守配置的图像清洗限制，与其他图像结果采用相同的 resize 策略。
• Doctor 修复： doctor --fix 现移除不可识别的 models.providers.*.models[*].compat.thinkingFormat 值，修复升级后 Provider 模型配置验证失败的问题。
• 媒体文件名解码： URL 路径中的文件名（如 My%20Report.pdf）现在在用作远程媒体备用文件名前先解码为正确文件名。
• 本地嵌入超时： 本地嵌入 Provider 在 active-memory 搜索超时时正确关闭，释放待处理的本地模型加载和嵌入上下文。
• Codex 图像生成超时： image_generate 动态工具调用现默认使用 120s 看门狗，不再错误回退到 30s 通用桥接超时。
• Docker Codex 保留： 官方 release 镜像的 keep 列表中保留内置 Codex 插件，修复 Docker 清理后默认 OpenAI agent harness 不可用的问题。
• CLI/update 重启健康检查： 修复 openclaw update 跨版本 CLI/Gateway 协议偏差时的重启健康检查，确保始终使用托管 Gateway service Node。
• Gateway status： gateway status JSON 输出现包含运行中 Gateway 版本。
• 插件发现性能： loadBundledCapabilityRuntimeRegistry、resolveBundledPluginSources 和 listChannelCatalogEntries 现传递显式插件发现结果，避免重复文件系统遍历。
• compaction 钩子超时： before_compaction 和 after_compaction 钩子现默认应用 30 秒超时，修复挂起插件处理程序阻塞压缩完成的问题。
• Agent trajectory flush 诊断： pi-trajectory-flush 超时警告现包含 bounded trajectory queued-writer 诊断，显示 pending writes、queued bytes 和 append state。

发布验证

• npm 包：https://www.npmjs.com/package/openclaw/v/2026.5.20-beta.1
• 完整性校验：sha256:6xBnBZqnqI4HoAs7CU1ZmzFDqPhe/aauKr0DsmMEReLvxap9DyLK7YPTTDU/A5v3dlSHlCgzFbVIvgTaUXgy4w==
• 完整验证流程：https://github.com/openclaw/openclaw/actions/runs/26195853190
• npm preflight：https://github.com/openclaw/openclaw/actions/runs/26195855712

原始发布链接

• GitHub Releases：https://github.com/openclaw/openclaw/releases/tag/v2026.5.20-beta.1