乐于分享
好东西不私藏

龙虾 OpenClaw 5 天 9 个 Beta:2026.5.7 之后更新全解析与升级指南

龙虾 OpenClaw 5 天 9 个 Beta:2026.5.7 之后更新全解析与升级指南

OpenClaw 在 2026.5.7(Latest 稳定版)发布后,5 天内密集推送了 9 个 beta 版本(2026.5.9-beta.1 至 2026.5.12-beta.6)。更新以安全加固和协议升级为主线,涉及 Gateway v4、权限模型收紧、pnpm 11 迁移等破坏性变更。本文梳理关键改动,并给出不同场景的升级建议。


版本现状

版本 时间 状态
2026.5.12-beta.6 9 小时前 Pre-release
2026.5.12-beta.1~5 1~3 天前 Pre-release
2026.5.10-beta.1/2 4 天前 Pre-release
2026.5.9-beta.1 5 天前 Pre-release
2026.5.7 上周 Latest(稳定版)

当前没有更新的稳定版,所有后续版本均为 beta。


核心变更

1. 安全加固(占比最大)

大量变更标记为 [AI] 安全改进,覆盖设备配对、网关命令、浏览器 CDP、内存访问等多个层面:

设备配对

  • setup-code、浏览器、Control UI 三类设备配对全部要求显式审批
  • 网关隐藏 pending 状态的 Node 配对命令、capability 和权限,审批通过后才会暴露

网关命令作用域

  • 命令执行强制校验 caller 上下文,禁止越权调用
  • Node 设备令牌管理需 admin scope
  • trusted-proxy 源验证硬化

浏览器 / 执行安全

  • sandbox 浏览器 CDP relay 需认证后才能访问
  • 浏览器交互(act)强制导航校验
  • 截断的 exec 审批命令直接拒绝
  • 内联 shell wrapper payload 强制匹配

内存 / 存储权限

  • memory-wiki ingest 需 admin scope
  • Obsidian search 需 write scope
  • Active Memory 全局开关需 admin scope

其他

  • 聊天发送者 allowlist 匹配收紧
  • webhook 速率限制(Google Chat、飞书)
  • 继承委托会话的工具限制

2. Gateway 协议 v4(Breaking Change)

  • 要求 v4 客户端:不再兼容旧版本 SDK/客户端
  • 流式帧格式变更:助手更新通过显式的 deltaText / replace 帧推送,客户端无需本地 diff
  • Talk session scope 传递给 resolver
  • 入站 /v1/chat/completions 正确透传 max_completion_tokens / max_tokens 到 upstream provider

3. 通道改进

Slack

  • 新增 unfurlLinks / unfurlMedia 配置,支持 per-account 覆盖
  • replyBroadcast 支持(线程回复可广播到父频道)
  • mention target/source 元数据保留到 prompt context
  • DM 路由规范化,message.sendD... 目标不再拆分会话

Discord Voice

  • 实时语音诊断:speaker turns、playback resets、barge-in detection、audio cutoff
  • 三种 /vc 模式:STT/TTS、realtime talk buffer、双向 realtime session
  • 默认模式改为 agent-proxy
  • voice.allowedChannels 限制语音加入范围
  • voice.realtime.minBargeInAudioEndMs 配置,解决 speaker echo 切断 model audio 的问题

Telegram

  • 支持 HTML 标签渲染(流式和 durable replies)
  • 无响应 DM turns 保持静默,不再转为可见 silent-reply
  • managed select button callbacks 处理优先级调整
  • 共享 grammY API throttler

WhatsApp

  • 拆分为独立 ClawHub/npm 插件,不再内置于 core bundle
  • Baileys 升级至 7.0.0-rc11
  • 可选音频解码依赖本地化到插件内,core npm install 不再拉取 WhatsApp-only 依赖

其他

  • 企业微信:官方插件刷新至 @wecom/wecom-openclaw-plugin@2026.5.7
  • 飞书:群组引用回复失败时 fallback 到顶层发送
  • iMessage:修复 media-only native image 的可见占位符问题
  • LINE:拒绝无 wildcard allowFromdmPolicy: "open" 配置

4. 代理与 Codex

  • 新增 /context map:生成当前会话上下文贡献者的 treemap 图像
  • Codex 集成调整:harness 支持 auth-profile 存储的 OpenAI 认证;app-server 默认拥有 workspace/edit/patch/exec/process/plan 工具;超时客户端自动清理
  • LLM idle watchdog:在 provider stream setup pending 阶段也生效,防止 pre-stream 静默 hang
  • 子代理优化:session picker 中以 visual prefix 嵌套显示子代理会话;跳过冗余 heartbeat wake-ups
  • agent-to-agent maxPingPongTurns:上限放开至 20(默认仍为 5)
  • per-agent 消息工具策略:支持 tools.message.crossContexttools.message.actions.allow 等覆盖

5. 插件与 SDK

SDK 清理

  • 废弃无生产导入的公共子路径
  • 移除 provider-auth-login 公共子路径,Chutes/GitHub Copilot/OpenAI Codex auth flow 回归 provider-owned module
  • 移除 provider-specific model/stream/xAI 兼容性 helper 的公开导出
  • 新增统一 model catalog 注册(text/image/video/music)
  • 暴露 runtime-supplied active model metadata 给原生插件 tool factory

安装/卸载

  • 安装时 peer dependency 处理改进:install 时保留、uninstall 时清理
  • 限制 install-time code safety scan 范围至 plugin-owned runtime entrypoints

6. Provider / 模型

Provider 变更
OpenAI openai/chat-latest 显式支持;CLI auth 默认走 ChatGPT/Codex OAuth(--method api-key 显式指定 API Key);Realtime 接受 Codex-compatible 遗留事件别名
Google Gemini gemini-3-pro-preview 统一归一化为 google/gemini-3.1-pro-preview(多处)
Anthropic claude-haiku-4-5 加入 API-key agent allowlist;重播 thinking blocks 剥离;Claude CLI session retry 重播时从历史 bounded 重播
xAI/Grok `/think low
Fal GPT Image 2 / Nano Banana 2 edit 请求路由至 /edit,edit mode input-image caps 提升至 10/14
Bedrock serviceTier 参数支持(default/flex/priority/reserved)
GitHub Copilot 刷新 model catalog;image understanding 请求 OAuth token 交换修复

7. 基础设施

  • pnpm 11:工作区包管理、Docker、install/update/release 全链路升级
  • Node 22 floor:最低支持版本提升至 22.16+(推荐 Node 24)
  • Docker:tini 初始化;pin setup-time container path 防止 .env 路径泄漏;mount auth-profile secret key 目录
  • CLI:parser/startup/config/guardrail/channel/agent/task/session/MCP 失败信息改进,指向恢复命令;cron.get / openclaw cron get <id> 支持
  • Control UI:PWA/favicon 资源路由修复;exec policy badge 读取路径修正;session compaction 历史卡片

升级建议

生产环境:留在 2026.5.7,等 stable

当前所有后续版本均为 beta,且包含多项 breaking change(Gateway v4、pnpm 11、SDK 子路径废弃)。建议等待 2026.5.12 正式版发布后,先在 staging 验证再上线。

测试/开发环境:可试用 2026.5.12-beta.6

如希望提前评估,建议按以下 checklist 执行:

检查项 操作
SDK/客户端兼容性 确认所有接入方支持 Gateway v4 协议
pnpm 版本 升级至 11
自定义插件 扫描是否有废弃 SDK 子路径的 import,迁移至新接口
OpenAI 认证 Codex 相关认证如需 API Key 方式,显式加 --method api-key
Gemini 模型 ID 全局搜索 gemini-3-pro-preview,替换为 gemini-3.1-pro-preview
审批策略 配置设备配对审批流程,确保管理员权限到位
Node.js 版本 升级至 22.16+

个人用户:佛系等推送

如无特定功能需求(如 /context map、Discord voice 新模式),等正式版自动推送即可。


风险评估

等级 变更 影响
Gateway v4 协议 旧 SDK/客户端不兼容,必须升级
设备配对审批 未配置审批策略将导致新设备无法接入
pnpm 11 CI/CD 和构建环境需同步升级
SDK 子路径废弃 自定义插件可能编译/运行时报错
Codex 工具集调整 依赖 Codex 的 agent 行为可能有微妙变化
新增 CLI 命令 向后兼容,无风险

小结

2026.5.7 之后的更新是一次以安全和协议升级为核心的基础设施迭代。Gateway v4 和全新的设备配对审批模型是两大关键变更,前者影响集成兼容性,后者影响运维配置。不建议生产环境盲目追 beta,稳定版 2026.5.7 仍是最可靠的选择。2026.5.12 大概率是下一个 stable release,可重点关注。


基于 OpenClaw GitHub 官方 releases 公开信息整理。如有出入,以官方文档为准。