一、版本基础信息
-
版本号:v2026.5.5
-
发布者:E steipete(Peter Steinberger)
-
发布时间:2026-05-06T09:00:00Z(UTC)
- 项目地址:https://github.com/openclaw/openclaw/releases/tag/v2026.5.5
-
提交哈希:b1abf9d
-
提交验证:已通过SSH密钥签名验证,密钥指纹:WmI9lVtd7F2c5XyRHbZVO3yYYJzwsSNzcZQMPT147HI
二、核心亮点
-
此版OpenClaw全渠道通讯适配集中修复:覆盖飞书、LINE、Telegram、Discord、Slack、Matrix等主流渠道,解决会话路由、消息投递、权限校验等核心异常,保障多渠道机器人稳定运行。
-
大模型服务商适配升级:修复xAI Grok 4.3模型推理参数报错,适配Fireworks Kimi系列模型,优化OpenAI兼容接口流式响应首包延迟问题。
-
Control UI会话管理全面重构:升级会话列表布局、新增运行时筛选能力,修复会话历史丢失、钩子触发异常问题,优化大负载下界面响应速度。
-
网关全生命周期稳定性增强:完善启动、运行、关闭全流程优化,修复心跳重连误判、后台定时器泄漏、事件循环健康度误报等核心问题。
-
运维与诊断能力大幅提升:升级doctor工具修复能力,新增网关状态深度诊断、插件安装问题引导、会话垃圾自动清理能力,降低运维成本。
三、多通讯渠道核心修复与优化
(一)飞书(Feishu)
会话路由前预填充缺失的原生主题发起线程ID,确保首次消息与后续回复始终保持在同一主题会话中,修复会话拆分异常问题。
(二)LINE
新增配置校验规则,未配置通配符allowFrom的dmPolicy: “open”配置将直接触发验证失败,避免webhook私信被确认后静默拦截的问题。
(三)Telegram
修复Codex工具进度草稿重复渲染问题,仅为每个工具渲染一次原生进度,同时保持仅消息工具的进度草稿可见性。
(四)Discord
-
修复心跳超时误判问题:从实际心跳发送时间开始计算ACK超时,避免初始心跳延迟触发错误的重连循环。
-
修复纯文本控制命令(如/steer)被静默丢弃的问题,将其纳入正常授权与提及校验流程。
-
优化流式回复体验,在进度草稿中展示实时推理文本,替代原有的空白Reasoning状态行。
(五)Slack
重连日志完整保留Socket Mode SDK错误上下文与结构化API字段,避免启动失败仅输出无意义的unknown error。
(六)Matrix
审批消息投递新增最多3次带退避重试机制,避免临时发送失败导致审批提示滞留无法处理。
四、Control UI 与交互体验全面升级
-
会话列表重构:压缩历史版本计数为N Checkpoint(s)折叠展示,新增现代化检查点历史卡片,全响应式表格布局适配多终端。
-
性能优化:保障聊天/频道标签页在历史负载、频道探测慢查询场景下的响应性,新增部分频道状态标记,慢渲染耗时自动记录至事件日志。
-
会话生命周期修复:仅在Control UI显式创建会话时触发/new命令与生命周期钩子,恢复会话记忆与自定义钩子捕获能力。
-
聊天历史修复:持久化保留助手进度文本,修复会话重载后含工具调用元数据的回复意外消失的问题。
-
功能增强:会话列表展示每个会话的代理运行时,支持按运行时标签筛选,与代理面板表述保持一致。
五、大模型与服务商适配升级
(一)xAI Grok 模型
-
停止向原生Grok Responses模型发送OpenAI风格的推理力度控制参数,修复xai/grok-4.3模型运行时Invalid reasoning effort报错问题。
-
捆绑的xAI思考配置默认锁定为off,避免网关运行时向模型发送不支持的推理等级。
(二)Fireworks Kimi 系列模型
将Kimi模型标记为仅支持关闭思考模式,K2.5/K2.6请求强制锁定thinking: disabled,避免手动切换模型时发送服务商不支持的reasoning*参数。
(三)OpenAI 兼容接口
-
流式聊天补全接口在请求头被接受后立即发送助手角色SSE块,避免冷启动代理初始化导致客户端空200响应超时。
-
修复初始聊天流首包刷新异常,确保首Token流式可见,无延迟卡顿。
(四)视频生成能力
-
工具边界支持服务商专属的宽高比、分辨率提示,自动将720P归一化为MiniMax支持的768P。
-
停止向Gemini视频请求发送Google generateAudio参数,保障服务商降级机制可正常恢复模型参数不兼容问题。
六、网关与底层架构优化
-
关闭流程加固:关闭时取消延迟的就绪后维护任务,快速重启时抑制维护/定时任务启动,避免后台孤儿定时器泄漏。
-
事件循环健康度优化:避免快速重复的健康检查仅因CPU/利用率就标记为事件循环降级,需累积持续采样窗口后再判定。
-
HTTP路由优化:非相关请求不加载托管的外发图片媒体处理程序,禁用的OpenAI兼容路由直接返回404,无需等待懒加载媒体侧边服务。
-
关闭结果结构化:通过ShutdownResult上报结构化关闭警告与HTTP关闭超时警告,同时保留生命周期钩子安全加固。
-
上下文引擎隔离:OpenClaw运行时隐藏的自定义消息不进入上下文引擎的组装、轮次后处理、摄入钩子,保障转录重建插件仅获取会话对话消息。
七、插件、CLI与运维工具增强
(一)插件管理
-
主机更新时自动同步已安装的官方npm/ClawHub插件(Codex、Discord、WhatsApp、诊断插件等),无论插件是否禁用、是否固定版本,同时保留第三方插件固定配置。
-
插件安装前修复陈旧的npm根目录openclaw对等依赖,避免旧的核心package-lock状态导致beta渠道官方插件更新被降级。
-
共享根目录npm操作后重新声明插件的openclaw对等依赖链接,避免单个插件变更导致其他已安装插件无法解析SDK路径。
-
插件更新时容忍损坏的托管插件记录,保障核心包更新可正常完成,并上报插件修复路径。
(二)CLI工具优化
-
openclaw channels父级帮助命令跳过配置、代理、插件启动引导,直接输出帮助信息后快速退出,无额外加载耗时。
-
openclaw status会话行展示选中的代理运行时/执行环境,终端输出与聊天内/status命令保持一致。
-
openclaw sessions表格新增代理运行时展示,支持按运行时筛选;默认限制会话选择器为最近行,优化海量历史会话下TUI响应速度。
-
sessions cleanup命令新增旧的未引用转录本、压缩检查点、轨迹产物清理能力,避免网关重启/崩溃遗留的孤儿文件无限累积。
-
开发渠道更新预检查lint改为可选启用,避免Ubuntu主机OOM或并行lint分片失败导致正常的主版本提交更新回退。
(三)Doctor运维诊断工具
-
doctor –fix新增心跳污染的默认主会话存储修复能力,将异常条目迁移至恢复键,清除陈旧的TUI恢复指针。
-
新增OPENCLAW_GATEWAY_TOKEN环境变量覆盖配置文件token的警告,避免本地CLI命令权限异常,同时规避误报。
-
openclaw doctor –deep与openclaw gateway status –deep新增监管服务重启交接记录上报,区分服务管理的干净重启与异常停止。
-
Codex专项修复:自动修复配置中遗留的openai-codex/*旧路由为规范的openai/*格式,自动匹配Codex插件运行时可用性,不可用时自动降级至pi运行时。
八、TUI 终端交互优化
-
交互式启动跳过通用CLI重包装,终端断开时干净退出,拒绝将心跳会话恢复为记忆聊天会话,避免首次启动出现陈旧心跳历史与孤儿进程。
-
会话选择器限制为最近行,活跃会话采用精确查找式刷新,避免海量历史会话导致TUI启动时加载数周前的转录本而卡顿。
-
非TTY标准输入在CLI命令完成后暂停,网关请求/授权失败时openclaw agent不回退到嵌入式模式,保障父级帮助命令干净退出,同时直接暴露真实网关错误。
九、安全与容器加固
-
Docker容器安全增强:捆绑的docker-compose.yml中移除网关容器的NET_RAW与NET_ADMIN权限,启用no-new-privileges,收缩容器攻击面。
-
Windows执行审批加固:Windows系统拒绝exec-approvals.json重命名覆盖时,自动降级到受保护的副本方案,同时保留符号链接、硬链接与仅所有者权限的安全防护。
-
iOS配对安全优化:仅允许私有局域网与.local网关使用ws://协议,公网/Tailscale路由强制使用wss://;混合认证重连时优先使用显式网关密码,而非陈旧的引导令牌。
-
授权配置优化:格式级别的请求拒绝不会触发服务商冷却,模型名称不支持时仍可正常尝试降级备用配置文件。
十、媒体与Codex专项优化
(一)Codex体验优化
-
Codex应用服务器生成的本地图片自动托管到网关媒体管理后再展示,修复Codex主页图片路径触发的LocalMediaAccessError,同时不放宽Codex目录的展示白名单。
-
修复Codex工具进度草稿重复渲染问题,优化Telegram等渠道的Codex工具交互体验。
(二)媒体生成优化
-
附件式消息工具动作视为已完成的聊天发送,避免生成的文件已上传后仍重复发送兜底媒体消息。
-
异步视频/音乐生成完成前,不触发直接生成媒体的兜底降级,避免重复发送原始媒体消息。
十一、其他细节优化
-
会话内存钩子:/new与/reset命令的会话归档文件名新增冲突后缀,避免同一分钟内重复操作覆盖之前的会话存档;重置内存捕获移至命令回复路径外,避免阻塞消息渠道的重置回复。
-
模型目录缓存:空的只读模型目录结果会缓存至重载前,避免无可用模型时TUI与控制面板刷新循环频繁读取插件元数据。
-
移除运行时路径中歧义的legacy main代理目录助手,模型、授权、网关等核心逻辑均通过agents.list与代理作用域助手解析,插件SDK保留弃用的兼容导出。
-
WhatsApp响应性优化:仅停止已验证的、会导致网关事件循环降级与回复延迟的陈旧本地TUI客户端,保障主线程响应速度。












