OpenClaw v2026.5.5 版本更新速览

最新发布版本：v2026.5.5
发布日期：2026-05-06 09:00 UTC

重点更新

本次版本在插件管理、终端界面（TUI）、控制面板、通道兼容性等多个方面进行了大量优化和问题修复。

项目亮点

• ⚠️ 包含破坏性变更：升级前请仔细阅读变更详情
• 📦 插件系统大幅增强：官方插件（Codex、Discord、WhatsApp 等）在宿主更新时自动同步，即使被禁用或锁定版本也能保持更新
• 🖥️ TUI 终端体验优化：启动更流畅、会话加载更快、心跳历史不再阻塞首次启动
• 🎛️ 控制面板（Control UI）改进：会话管理新增运行时效标、断点历史卡片、运行时筛选等功能
• 🔒 Docker 安全加固：容器默认删除 NET_RAW 和 NET_ADMIN 能力，启用 no-new-privileges
• 🔧 诊断工具增强：doctor --fix 可修复心跳中毒的会话记录，doctor --deep 展示重启移交信息
• 📱 通道修复：飞书话题路由、LINE 配置校验、Discord 重连、WhatsApp 响应性等问题全面修复
• 🧠 提供者兼容性：xAI Grok、Fireworks Kimi 模型参数适配，避免无效参数导致请求失败

**请注意**：本次版本包含破坏性变更或兼容性调整，请仔细阅读变更详情后再升级。

功能改进与变更

插件管理

• 宿主更新时自动同步已安装的官方 npm 和 ClawHub 插件（如 Codex、Discord、WhatsApp），即使被禁用或已精确锁定版本，同时保留第三方插件的锁定（感谢 @vincentkoc）
• 插件安装/更新/卸载后，自动重新建立管理的 npm 插件 openclaw 对等链接，避免操作一个插件导致其他已安装的 SDK 插件无法解析 openclaw/plugin-sdk/*（感谢 @vincentkoc）
• 插件安装前修复过期的 npm 根目录 openclaw 对等包，避免 Beta 频道官方插件更新被旧的核心包锁定状态降级（感谢 @vincentkoc）
• 插件更新时容忍损坏的管理记录，确保核心包更新能顺利完成并报告修复路径

控制面板（Control UI）

• 会话压缩数显示为紧凑的 N 个断点 提示，响应式表格布局中展示展开的会话级详情和现代断点历史卡片（感谢 @BunsDev）
• 历史载荷和通道探测慢时保持聊天/通道标签页响应，标记部分通道状态，并在事件日志中记录渲染耗时（感谢 @BunsDev）
• /new 命令和生命周期钩子仅在明确的控制面板会话创建时触发，恢复会话记忆和自定义钩子捕获（感谢 @BunsDev）
• 会话表中显示每个会话的 Agent 运行时，支持按运行时标签筛选（感谢 @vincentkoc）

终端界面（TUI）

• 交互式启动时跳过通用 CLI 重生成包装器，终端关闭时干净退出，拒绝将心跳会话恢复为历史聊天会话，避免首次启动时残留旧心跳历史和孤立的 openclaw-tui 进程（感谢 @vincentkoc）
• 会话选择器限制在最近的行范围内，活跃会话使用精确查找刷新生效，避免陈旧存储导致 TUI 加载数周前的对话记录（感谢 @vincentkoc）
• openclaw status 会话行显示选中的 Agent 运行时，终端状态与 /status 运行时行一致（感谢 @vincentkoc）
• openclaw sessions 表显示选中的 Agent 运行时（感谢 @vincentkoc）

命令行界面（CLI）

• CLI/gateway：完整 CLI 命令完成后暂停非 TTY 标准输入，网关请求/认证失败时 openclaw agent 不再回退到嵌入模式（感谢 @vincentkoc）
• CLI/channels：跳过配置、代理、通道选项目录、横幅配置和插件启动引导，使 openclaw channels 父级帮助命令打印帮助后立即退出（感谢 @vincentkoc）
• CLI/update：开发频道预检 Lint 改为可选且受约束，避免 Ubuntu 主机内存不足杀死或并行 oxlint 分片失败时回退已合并的主提交（感谢 @vincentkoc）
• sessions cleanup 清理旧的未引用对话记录、压缩断点和轨迹文件，避免网关重启或崩溃孤儿文件在 sessions.json 外无限累积（感谢 @slideshow-dingo）

诊断工具（Doctor）

• 将心跳中毒的默认主会话存储条目移到恢复键，清除过期的 TUI 恢复指针，使 doctor --fix 可修复已卡在 agent:main:main 心跳历史的实例（感谢 @vincentkoc）
• doctor --deep 报告最近的 Supervisor 重启移交，尽可能使用已安装的服务环境（感谢 @shakkernerd）
• 当 OPENCLAW_GATEWAY_TOKEN 会覆盖其他活动的 gateway.auth.token 源时发出警告，同时避免配置指向同一环境变量时的误报（感谢 @yelog）
• 修复旧版 openai-codex/* 路由到规范 openai/*，仅在 Codex 插件已安装、启用、贡献 codex 运行时有可用的 OAuth 时选择 agentRuntime.id: "codex"，否则选择 agentRuntime.id: "pi"（感谢 @vincentkoc）

网关（Gateway）

• 关闭时取消延迟的后就绪维护，快速重启后抑制维护/定时任务启动，避免遗留后台定时器（感谢 @vincentkoc）
• 避免仅凭 CPU/利用率将快速重复的健康/状态采样标记为事件循环降级（感谢 @shakkernerd）
• 显示最近 Supervisor 重启移交的详细信息（包括 JSON），使干净的服务管理重启能正确报告（感谢 @shakkernerd）
• 避免为不相关的请求加载托管的出站图片媒体处理器（感谢 @vincentkoc）
• OpenAI 兼容路由：流式聊天补全头部接受后立即发送助手角色 SSE 数据块（感谢 @vincentkoc）
• 跳过不相关 HTTP 路由的媒体侧车处理
• 报告结构化的关闭警告和 HTTP 关闭超时警告（感谢 @edenfunf）
• 将空只读模型目录结果缓存到重新加载前（感谢 @vincentkoc）

提供者（Providers）

• xAI：停止向原生 Grok Responses 模型发送 OpenAI 风格的理由努力控制，避免实时 Docker/Gateway 运行因 Invalid reasoning effort 而失败
• xAI：将内置的 xAI 思考配置文件固定为 off，避免实时网关运行向原生 Grok Responses 模型发送不支持的推理级别
• Fireworks：将 Kimi 模型暴露为仅关闭思考模式，K2.5/K2.6 请求保持 thinking: disabled（感谢 @frankekn）
• OpenAI/Gateway：正确刷新初始聊天流数据块，使首 token 流式传输可见

视频生成

• 接受提供者特定的宽高比和分辨率提示，将 720P 规范化为 MiniMax 支持的 768P（感谢 @vincentkoc）
• 停止在 Gemini 视频请求中发送 Google generateAudio（感谢 @vincentkoc）

会话与记忆

• /new 和 /reset 捕获的记忆文件名添加冲突后缀（感谢 @vincentkoc）
• 重置记忆捕获在命令回复路径之外运行，模型生成的记忆文件名 slug 通过 llmSlug: true 可选启用（感谢 @vincentkoc）
• Agent 运行时隐藏的 OpenClaw 运行时上下文自定义消息不影响上下文引擎（感谢 @vincentkoc）

Agent

• 将附件风格的消息工具操作视为已完成的聊天发送，避免生成的媒体文件已上传时的重复回退发布
• 在 announce-agent 运行尚未完成时避免直接回退生成的媒体完成（#77754）
• 移除有歧义的旧版 main Agent 目录助手

状态显示

• /status 显示紧凑的网关进程运行时间和主机系统运行时间（感谢 @vincentkoc）
• Discord 流式传输中显示实时推理文本而非空白的 Reasoning 状态行
• 认证配置：避免因格式级别拒绝而将提供者置于冷却状态

问题修复

飞书

• 修复话题路由：补充缺失的原生话题起始线程 ID，确保首次消息和后续回复在同一话题会话中（感谢 @joeyzenghuan）

LINE

• 拒绝没有通配符 allowFrom 的 dmPolicy: "open" 配置，使 Webhook 私信验证失败而非被默认接受后静默拦截

Telegram / Codex

• 保持仅消息工具进度草稿可见，Codex 工具进度每次工具渲染一次，避免重复项目/工具草稿行

Discord

• 网关：从实际心跳发送开始测量心跳 ACK 超时，防止早期心跳延迟触发错误重连循环（感谢 @bryce-d-greybeard）
• 频道：将纯文本控制命令（如 /steer）通过正常授权和提及网关路由，避免 Agent 会话见不到命令前被静默丢弃（感谢 @ramitrkar-hash）
• 流式传输：在进度草稿中显示推理文本

Matrix

• 审批：审批投递最多重试 3 次，短暂退避，避免瞬时 Matrix 发送失败悬空待审批提示（感谢 @Patrick-Erichsen）

Slack

• 保留 Socket Mode SDK 错误上下文和结构化 Slack API 字段在重连日志中，使启动失败不再坍缩为裸 unknown error

WhatsApp

• 仅停止已验证的陈旧本地 TUI 客户端，当其降低网关事件循环并延迟回复时（感谢 @vincentkoc）

iOS 配对

• 私有局域网和 .local 网关允许使用设置码和手动 ws:// 连接，Tailscale/公共路由保持 wss://，混合认证重连中优先使用明确的网关密码而非过期的引导令牌（感谢 @draix）

WebChat / Codex

• 将 Codex 应用服务器生成的本地图片暂存到管理的媒体中再展示，避免 Codex 首页图片路径报 LocalMediaAccessError（感谢 @frankekn）

执行审批

• Windows 拒绝重命名覆盖 exec-approvals.json 时回退到受保护的复制，同时保留符号链接、硬链接和所有者权限保护（感谢 @Alex-Alaniz）

插件诊断

• 仅源码的 TypeScript 包警告改为可操作：说明缺少编译运行输出是发布者打包问题，引导用户更新/重装或禁用/卸载插件（感谢 @googlerest）

控制面板聊天

• 同一对话轮次包含工具使用元数据时保持已保存的助手进度文本可见，避免聊天.history 重载后下一次用户消息时消失（感谢 @BunsDev）

Agent/上下文引擎

• 隐藏的 OpenClaw 运行时上下文自定义消息不影响上下文引擎组装、afterTurn 和 ingest 钩子，使对话重构插件仅看到对话消息（感谢 @vincentkoc）

视频生成

• 在 Gemini 视频请求中停止发送 Google generateAudio，使提供者回退能从模型特定参数差异恢复（感谢 @vincentkoc）

其他

• 更新：开发频道获取失败后干净停止，不继续后续更新步骤
• 状态：展示紧凑的网关进程运行时间和主机系统运行时间（感谢 @vincentkoc）
• Docker：在 docker-compose.yml 中删除 NET_RAW 和 NET_ADMIN 能力，启用 no-new-privileges（感谢 @VintageAyu）
• Auth 配置：避免因格式级别拒绝而将提供者置于冷却状态
• 插件更新：容忍损坏的管理记录
• Agent/生成的媒体：将附件风格消息工具操作视为已完成的聊天发送

对用户的价值

如果你是普通用户

• 更稳定的体验：大量底层修复提升了 AI 回复的稳定性和可靠性
• 更快的响应：性能优化让聊天、工具调用响应更迅速
• 更好的兼容性：修复了 Windows、macOS、Linux 等平台的兼容性问题
• 更多模型支持：持续扩展支持更多 AI 模型和提供者

如果你是开发者/管理员

• 更完善的安全：SSRF 防护、命令注入检测等安全机制持续加强
• 更易诊断：控制面板新增调试信息和性能追踪
• 更灵活的插件系统：插件安装、更新、安全管理更可靠
• 更丰富的通道支持：Slack、Telegram、Discord、WhatsApp 等通道功能增强

升级方式

推荐：使用 openclaw update

openclaw update

其他方式

# npm
npm update -g openclaw

# pnpm
pnpm update -g openclaw

# Homebrew（macOS）
brew upgrade openclaw

**升级建议**：升级前建议备份配置文件。如遇问题可执行 `openclaw doctor –fix` 自动修复。

版本对比

项目

旧版本

新版本

OpenClaw

v2026.5.4

v2026.5.5

发布状态

已发布

正式发布

以上内容为版本更新的简要梳理，详细内容请以 官方 Release Notes^[1] 为准。

引用链接