OpenClaw v2026.5.4 版本更新一览

一、版本基础信息

• 版本号：v2026.5.4（Latest 最新版）
• 提交哈希：325df3e
• 发布作者：@steipete
• 发布时间：2026.5.5
• 适配场景：AI智能代理、多渠道机器人网关、语音通话、Google Meet会议接入、插件生态管理、企业级私有部署

二、核心亮点

1. Google Meet/语音通话重磅升级：接入Twilio拨号入会能力，全面对接Gemini实时语音桥，实现节奏可控音频流、背压感知缓冲、插话队列清空能力；实时语音场景不再依赖TwiML降级方案，大幅提升OpenClaw语音代理响应速度与通话流畅度。
2. DeepSeek V4 完整适配：原生支持DeepSeek V4模型及多档位推理思考级别，修复OpenRouter接口推理参数报错问题，兼容主流模型调度策略。
3. 全局性能大幅优化：网关启动、插件加载、会话列表、元数据扫描全链路减负，复用工作区插件元数据快照，规避重复冷扫描，降低内存占用与启动耗时。
4. 插件生态机制重构：优化ClawHub/npm插件自动迁移、版本兼容、灰度更新逻辑，官方插件可平滑从捆绑包迁移至npm分发，同时修复版本判定、依赖解析、安装冗余等问题。

三、详细更新内容

（一）网关 & 底层架构优化

• Windows平台仅将回环网关监听器绑定127.0.0.1与::1，修复libuv双栈协议导致本地HTTP请求阻塞问题。
• 拆分网关启动导入路径，将模型目录测试工具、QR配对、TypeBox构造等非核心逻辑延迟加载，降低启动负载与内存压力。
• 延迟非就绪侧边服务启动，规避热路径插件批量导入；优化原生插件加载逻辑，避免不必要的源码转换开销（避免导入jiti）。
• 新增启动阶段链路追踪、异步任务标签、终端桥接过期标记，完善网关卡顿、阻塞问题日志诊断能力，pnpm gateway:watch可输出更精准的调试信息。
• 修复Windows临时目录写入路径错误，日志、TTS临时文件自动归类至%TEMP%\openclaw-<uid>，替代原C:\tmp\openclaw路径。
• 加固WebSocket鉴权作用域、启动名称匹配、设备配对权限校验，收紧底层网关安全边界。
• 优化网关会话列表查询性能，缓存重复思考选项富集结果，限制RPC响应行数并标注截断元数据，避免海量会话导致性能雪崩。

（二）控制面板 UI 交互升级

• 仪表盘面包屑展示当前活跃代理名称，精简顶部导航布局，剔除冗余会话密钥显示，适配多终端视图。
• 定时任务（Cron）侧边栏支持折叠，节省列表展示空间，操作入口一键可达。
• 聊天会话选择器新增代理优先筛选，全尺寸自适应手机/平板/桌面端，优化头像刷新、滚动布局冗余问题，隐藏滚动时的聊天控制行。
• 自动合并连续重复消息气泡并标注计数，精简心跳应答刷屏问题，保留上下文关联性。
• 调试日志支持记录浏览器长任务、长动画帧，便于定位仪表盘渲染卡顿，同时限制日志容量，避免覆盖核心网关日志。
• 语音Talk组件优化：失败弹窗可手动关闭、自动清除过期会话、点击重试自动重建链路，修复永久异常横幅问题。
• 优化代码块、表格、长标识符渲染，修复终端内换行、空格注入问题，保证复制内容字节级完整。
• 完善国际化适配，会话活跃筛选提示可显示配置的分钟数，杜绝占位符漂移问题。

（三）多通讯渠道适配优化

1. WhatsApp

• 规范手机号白名单格式，兼容E.164、JID输入，自动归一化纯数字ID，匹配WhatsApp Web身份校验。
• 支持频道/新闻联播定向outbound消息发送，脱离默认DM路由规则。
• 优化登录QR码日志输出，全流程纳入运行时日志捕获，避免QR码信息丢失。
• 修复媒体附件写入权限问题，Windows平台可正常保存并同步附件。

2. Telegram

• 修复媒体附件占位符识别异常，非图片混合附件不再错误标记为<media:image>。
• 长文本流式回复复用预览块，避免出现瞬时多余气泡闪烁，提升交互流畅度。
• 支持论坛话题定向权限控制，覆盖话题单独提及开关配置，修复群聊会话ID解析崩溃问题。
• 清理工具临时预览残留气泡（如“Surfacing…”），优化交互体验；修复仅按钮消息无法正常推送问题。
• 支持插件所属数字论坛话题目标，修复会话路由异常。

3. Discord

• 优先使用IPv4协议建立网关连接，解决IPv4-only网络启动阻塞、消息分发延迟。
• 失败最终回复标记为会话失败状态，避免消息丢弃却显示已完成的逻辑错误。
• 异步重试READY握手，延迟非致命启动故障上报，提升WSL2等复杂环境稳定性。
• 新增降级状态监控，在openclaw channels status、openclaw status –deep中显示网关事件循环阻塞标记。

4. 其他渠道（Slack/飞书/企微/QQBot）

• Slack富文本进度草稿支持结构化数据渲染（streaming.progress.render: “rich”），自动裁剪超长内容并保留最新进度行。
• Slack子代理会话保留原线程上下文，抑制无效子任务完成日志刷屏。
• QQBot框架命令隔离作用域，私有指令（/bot-*）不对外暴露；修复群聊会话ID解析崩溃问题。
• 飞书、Mattermost复用统一流式进度格式化组件，兼容原始指令详情调试模式（agents.defaults.toolProgressDetail: “raw”）。
• Mattermost模型选择器明确提示仅修改会话模型，运行时切换需使用指定命令（/oc_model <provider/model> –runtime <runtime>）。

（四）智能代理 & 子代理能力增强

• 工作区元数据全链路透传，PDF解析、模型生成、数据压缩等场景复用快照，减少冷启动扫描。
• 新增压缩后循环防护机制，自动检测重复（工具、参数、结果）调用死循环，支持通过tools.loopDetection.enabled关闭、tools.loopDetection.postCompactionGuard.windowSize调整阈值。
• 精简模式默认压缩工具摘要与进度草稿，支持全局/单代理粒度切换原始详情模式（agents.defaults.toolProgressDetail: “raw”）。
• 子代理保留分组子任务完整结果，修复降级场景上下文丢失问题；刷新延迟最终交付 payload，确保重试通知使用最新结果。
• 优化记忆子代理容错，未加载memory-core、memory-lancedb等记忆插件时静默跳过，不再抛出误导性工具缺失告警。
• 会话缓存隔离轮次上下文，恢复聊天续写提示缓存复用能力，降低Token消耗。
• 优化Pi嵌入式运行器，抑制合成中间溢出续写提示的持久化，避免转录重试时生成无效用户轮次。

（五）OpenAI / Codex / 第三方模型适配

• Codex音频转录能力纳入运行时与元数据声明，分流聊天模型与音频转录模型路由，避免聊天模型ID误传。
• OpenAI Responses模型默认采用SSE传输，规避WebSocket链路阻塞导致会话挂起。
• 重构Codex授权逻辑，失效账号自动迁移至有效登录配置，修复OAuth绑定残留问题；完善安全校验，拒绝畸形控制指令。
• 兼容Codex上游实验协议，自动格式化TypeScript代码，保持版本兼容性，修复协议漂移问题。
• OpenRouter新增缓存策略（X-OpenRouter-Cache、X-OpenRouter-Cache-TTL）、应用分类上报，精准适配DeepSeek V4推理参数映射。
• 新增openclaw models auth list [–provider <id>] [–json]命令，可安全查看代理授权配置、不泄露明文密钥。

（六）插件生态 & 命令行工具升级

• 插件迁移优化：未安装官方外部插件时主动给出“plugins install <spec>”安装提示，不再强制删除合法配置。
• 版本兼容逻辑升级：修正版号（如2026.5.3-1）识别为正式稳定版，支持插件正常适配升级，修复版本判定错误。
• 插件自动更新：平滑切换pnpm/npm安装前缀，清理废弃捆绑包加载路径，避免多版本冗余共存；支持ClawHub/npm源自动切换与修复。
• 插件加载容错：原生模块（.js）加载失败不再误触发源码降级，保留真实报错信息便于排查。
• 安全扫描白名单：官方npm插件（如@openclaw/discord）、管理员指令（/plugins install）安装跳过风险规则误报。
• 插件SDK增强：新增before_agent_finalize重试指令、registerIfAbsent原子键声明、会话扩展读取等能力。
• CLI工具优化：update命令支持绝对POSIX npm脚本shell，修复受限环境更新失败；sessions命令默认限制100行输出，支持–limit参数调整。

（七）密钥配置 & 运维诊断工具

• 密钥清理时保留auth-profile、keyRef、tokenRef等配置结构与引用元数据，仅清除明文敏感字段。
• 外部频道合约自动检索<rootDir>/dist/secret-contract-api目录下声明文件，修复2026.5.3版本环境变量密钥解析失败问题。
• doctor –fix工具全面增强：清理过期会话路由、修复插件白名单、恢复群聊历史权限配置、清理冗余插件安装记录，修复legacy配置迁移问题。
• 状态诊断新增Discord降级状态、事件循环阻塞标记，便于定位间歇性连接重置问题；网关状态中Linux托管服务明确标注为systemd user，区分用户级与系统级服务。
• 新增pnpm openclaw qa mantis slack-desktop-smoke命令，支持Slack桌面端QA测试，捕获截图与 artifacts。

（八）语音通话 & Google Meet 专项优化

• 限定Twilio音频队列上限，过载流主动关闭，防止websocket背压导致音频堆积。
• 通话合成优先读取服务商自定义音色/模型配置，日志与实际后端音源保持一致。
• 支持自定义静音欢迎语（realtime.introMessage: “”），保留静默入会配置不被默认话术覆盖。
• 拆分转录/双向语音独立配置，支持doctor –fix自动迁移旧版配置；默认采用agent模式（转录+TTS），bidi模式作为双向语音 fallback，realtime作为兼容别名。
• 优化Chrome音频缓冲区大小（默认4096字节），降低双向通话时延；新增麦克风静音等待重试逻辑，避免永久跳过通话。
• 抑制会议回声，避免代理自身语音被识别为用户输入；fork会议参与者当前代理转录，确保回复上下文连贯。

（九）跨平台、Docker 与安全加固

• Docker镜像裁剪：按需剔除未启用插件编译产物，减小镜像体积，修复Feishu等插件部分元数据泄露问题。
• Windows沙盒支持绝对磁盘路径绑定，路径校验大小写不敏感，兼容本地目录挂载规则。
• 严格强化SSRF防护，截图、页面调试等操作前置URL策略校验，杜绝越权访问。
• Windows系统环境变量、注册表、命令路径严格锁定系统安装目录，禁止工作区变量劫持systemRoot、windir、cmd.exe等系统工具。
• 执行命令审批新增Shell拆分字符串、环境变量隐式命令（如env -S、exec）风险检测，提升命令执行安全审计能力。
• 媒体文件处理优化：HEIC/HEIF图片在Sharp转换不可用时 fail-closed；Windows平台附件读写权限修复，避免EPERM错误。

（十）重点问题修复汇总

• 修复会话重复运行锁判定错误，解决连续聊天请求互斥阻塞。
• 修复媒体附件重复发送、HEIC/HEIF图片降级处理失败问题。
• 修复Linux/macOS Docker挂载路径权限报错、工作目录持久化异常。
• 修复插件源仅含TS源码无编译产物时阻塞全局插件加载问题。
• 修复定时任务工具权限校验失效，异常任务无法上报真实失败原因。
• 修复大量渠道消息去重、线程上下文、模型切换、会话绑定等边缘场景Bug，提升整体稳定性。

四、发布资源

1. Source code (zip)，发布时间：2026-05-05T07:37:36Z
2. Source code (tar.gz)，发布时间：2026-05-05T07:37:36Z