OpenClaw 小龙虾 2026.5.2 更新说明
✨ 亮点
- 外部插件安装体系全面升级： install/update/doctor repair/dependency reporting/artifact metadata 现在覆盖 npm 迁移、过时配置安装、缺失包负载和 beta 频道回退
- Gateway 和 Agent 热路径优化： 启动、会话列表、任务维护、提示准备、插件加载、工具描述符规划、文件系统守卫和大型运行时配置全面瘦身
- Control UI / WebChat 更稳健： Sessions、Cron、长连接 WebSocket、分组消息宽度、斜杠命令反馈、iOS PWA 边界、选择对比度和 Talk 诊断
- 消息通道修复： WhatsApp Channel/Newsletter 目标、Telegram 话题命令和网络、Discord 交付/启动边缘情况、Slack 线程、Signal 群组/媒体、可见回复路由
- Provider 和媒体修复： OpenAI 兼容 TTS/Realtime、OpenRouter/DeepSeek 重放、Anthropic 兼容流式、LM Studio 推理元数据、Brave/SearXNG/Firecrawl 网页搜索、媒体路径、音乐和语音通话路由
🚀 新功能
Gateway/启动与重启
- 启动密钥预检时跳过插件支持的身份配置文件覆盖，降低 Gateway 就绪延迟，同时保留重载和 OAuth 恢复路径的覆盖能力 (#68327)
- 新增
openclaw gateway restart --force 和 --wait <duration>
- 重启推迟定时器前记录活跃任务运行 ID，超时重启报告为显式强制重启
插件系统
- ClawHub： 诊断、引导、doctor repair 和频道设置现在在安装记录中携带 ClawPack 元数据
- CLI：
openclaw plugins list --json 现在包含包依赖安装状态，无需运行时加载即可检测缺失依赖
- 更新频道： beta 频道上默认 npm 和 ClawHub 插件更新先尝试
@beta，无 beta 版本时回退到 default/latest
- 运行时： 范围化运行时预加载，仅加载配置、启动计划、已配频道、slot 和自动启用规则中的有效插件 ID
- Git 插件安装： 支持
git: 协议安装，包含 ref checkout、commit 元数据、常规扫描/staging 和 plugins update 支持
- Crestodian： 新增 ClawHub 插件搜索 + Crestodian 插件 list/search/install/uninstall 操作，含审批和审计覆盖
- Beta 化： 将 ACPX 和 diagnostics OpenTelemetry 外部化为独立包；准备 Google Chat、LINE、Matrix 等 20+ 插件进行 npm/ClawHub 发布
Provider 更新
- xAI： 新增 Grok 4.3，设为默认 xAI 聊天模型
- Google Meet： API 创建的房间支持 accessType/entryPointAccess 配置；新增
end-active-conference；新增 test-listen 操作
- OpenAI： 兼容 TTS 端点增加 extraBody/extra_body 透传，支持
lang 等字段
频道改进
- WhatsApp： 支持显式 Channel/Newsletter
@newsletter 出站消息目标
- Discord： 支持可复用的消息频道访问组；按钮/选择框/表单在 Gateway 重启后保持有效直至过期
- Slack： 发布安全的默认 App Home 标签页视图；跟踪跨重启的 bot 参与线程
- Telegram： 持久化斜杠命令部署哈希跨进程；保持插件命令在论坛话题中可用
- BlueBubbles： 新增可选
replyContextApiFallback 配置
- 主题绑定： 用
threadBindings.spawnSessions 统一替代 split subagent/ACP 主题生成开关
Control UI / WebChat
- 新增
chatMessageMaxWidth 配置
- 忽略格式错误的持久化 cron 行；保护过期 cron 渲染路径
- Sessions 标签页默认查询限制为近期活动和更少行数，保留可编辑过滤器
- iOS PWA 安全区域适配；高对比度文本选择颜色
- 长连接 Dashboard WebSocket 保持存活；重连后保持 Stop 可用
/new 通过 New Chat dashboard 会话创建流程路由；/reset 保留为显式重置
其他
- CLI/proxy： 新增
openclaw proxy validate 验证代理配置、可达性和规则行为
- Gateway/SDK： 新增 SDK 端
tools.invoke RPC，含共享 HTTP 策略、类型化审批/拒绝结果
- Heartbeat： 新增结构化
heartbeat_respond 工具
- Gateway/config：
$include 指令支持从 OPENCLAW_INCLUDE_ROOTS 目录读取文件
- Codex： 澄清文档中 ChatGPT/Codex 订阅应使用
openai/gpt-* + agentRuntime.id: "codex"
🔧 修复
Gateway & Agent 核心
| 修复项 |
详情 |
| GPT-5 回复 |
默认 GPT-5 API key 会话使用 SSE Responses 传输而非 WebSocket |
| 会话卡在 running |
防止过期内存快照导致终态生命周期状态卡死 |
| Gateway 启动修复 |
修复指向旧版本/缺失二进制/临时安装路径的托管服务定义 |
| 大型配置启动阻塞 |
避免重复插件工具描述符配置哈希导致超时重连 |
| 运行超时误报 |
工具执行期间的超时不触发模型回退或错误合成 |
| z.ai 风格 Provider Pi 重置 |
连续轮次保留上下文 |
| 会话写入锁超时 |
默认提高到 60 秒 |
| 重启恢复 |
匹配主题后缀的会话锁路径 |
插件 & CLI
| 修复项 |
详情 |
| 插件更新恢复 |
检测目录消失的插件安装记录，先重新安装再正常更新 |
| Git 插件路径 |
保持路径免凭证；保留现有 checkout 至替换成功 |
| CLI 命令缓存 |
缓存插件 CLI 注册条目避免重复扫描 |
| 非插件命令 root |
不再视为 bundled plugin ID |
| Crestodian 非 TTY |
无终端时退出码非零 |
| 插件安全审计 |
忽略安装备份、禁用和依赖目录 |
频道修复
| 修复项 |
详情 |
| Discord 连接 |
共享 IDENTIFY 并发窗口期间重新连接 |
| Discord 打字指示器 |
长时间工具运行和自动压缩期间保持活跃 |
| Discord PluralKit |
代理 webhook 转写去重、线程注入优化 |
| Telegram 限长消息 |
分割长 Markdown 消息为安全 HTML 块 |
| Telegram Bot API 超时 |
出站文本和打字指示器提升至 60s |
| Slack DM 路由 |
多个路由修复和稳定 |
| Slack DM 文本恢复 |
从 rich-text 块恢复完整 DM 文本 |
| WhatsApp Baileys |
关闭长连接时正确清理 |
| Feishu 错误详情 |
保留 HTTP 400 响应中的 vendor code 等信息 |
| Cron 推送 |
隔离 cron 推送不累积在主会话中 |
| 子代理重复回复 |
避免 sessions_send 产生重复父会话可见回复 |
Provider 修复
| 修复项 |
详情 |
| DeepSeek V4 推理回放 |
填充 OpenRouter 路径的占位符 |
| LM Studio 推理元数据 |
标准化 Gemma 4 等本地模型的二进制元数据 |
| Anthropic 流式文本 |
恢复在内容块之前到达的流文本 delta |
| OpenRouter Anthropic 预填充 |
启用推理时剥离尾部助手预填充轮次 |
| Grok web_search 超时 |
默认 60s 超时，结构化超时错误 |
| Proxy 下音频上传 |
修复 [object FormData] 问题 |
| MiniMax 搜索 |
支持 OAuth token 和 base URL 覆盖 |
Control UI / WebChat / TUI
| 修复项 |
详情 |
| TUI 重新连接 |
重新连接后保持同一会话 ID |
| TUI 重新启动 |
恢复上次选中的会话 |
| Dashboard WebSocket |
协议 ping 保持活跃 |
| Slash 命令 |
兜底命令元数据使用浏览器安全路径 |
| Media 附件 |
修剪序列化 JSON 后缀防止 ENOENT |
| Cron 格式错误行 |
不终止整个 tick |
其他修复
- Memory Wiki：接受含
.md 后缀的相对 Markdown 链接
- Pi 大文件：避免重新打开大型转录文件
- 沙盒：保持文件模式（0644 不坍缩为 0600）
- 会话存储：停止持久化
skillsSnapshot.resolvedSkills
- 音频/媒体：修复多项媒体路径和事务正确性问题
- TTS：要求显式用户或配置音频意图
📦 依赖更新
| 包 |
版本 |
| TypeBox |
1.1.37 |
| AWS SDK |
3.1041.0 |
| Microsoft Teams |
2.0.9 |
| Marked |
18.0.3 |
| Pi |
0.71.1 |
| OpenAI |
6.35.0 |
| Codex |
0.128.0 |
| Zod |
4.4.1 |
| Matrix |
41.4.0 |
📊 统计概览
- 亮点： 外部插件安装体系全面升级，热路径性能优化
- 新功能： Gateway 重启选项、Grok 4.3、Git 插件安装、Crestodian ClawHub 集成、BlueBubbles 回退、Google Meet 增强等
- 修复： 涵盖 Gateway、Agent、插件、频道（Discord/Telegram/Slack/WhatsApp/Feishu）、Provider、Control UI 等 100+ 项修复
- 安全： BlueBubbles 日志敏感信息脱敏（CWE-532）、SSRF 防护强化、插件安全审计改进
- 依赖更新： 9+ 核心依赖升级
「以上就是本芙宁娜大人整理的全部内容啦！」 🎭✨
