OpenClaw 升级报告(2026.4.29 → 2026.5.3)

一、OpenClaw 升级报告（2026.4.29 → 2026.5.3）

当前版本： 2026.4.29 (Apr 30)  

最新稳定版： 2026.5.3 (May 4)  

升级跨度： 5个小版本，约5天迭代

—

1️⃣ 新增功能

文件传输插件（File Transfer Plugin） 🆕

– 全新内置插件，提供 file_fetch、dir_list、dir_fetch、file_write 四个 Agent 工具

– 支持二进制文件操作，可跨节点传输文件

– 安全模型：默认拒绝路径穿越，符号链接默认禁止，可选 followSymlinks 开启

– 单次传输上限 16 MB

ClawHub 插件市场

– 支持从 ClawHub 搜索、安装、卸载插件，完整的 npm fallback 机制

– 支持 git: 源直接安装插件（含 ref checkout 和 commit metadata）

/steer 命令

– 无需开启新 turn，直接干预当前正在运行的 session

– 队列无关的实时导向控制

统一流式输出模式

– streaming.mode: “progress” 在 Discord、Telegram、Matrix、Slack、Teams 全平台统一

– 流式输出时显示单字状态标签（”Thinking…””Writing…””Searching…”）

/side 命令

– /btw 的文本别名，用于临时追问

Google Meet 深度集成

– 支持 API 创建会议室（accessType/entryPointAccess）

– Twilio 拨号加入，音频通过 Realtime Gemini 语音桥接

– 新增 googlemeet end-active-conference 结束会议命令

NVIDIA Provider 正式上线

– 新增 NVIDIA 模型供应商，API Key onboarding + 静态模型目录

—

2️⃣ 修复的 Bug

| Bug | 说明 |

|—–|——|

| `#76798` | `doctor –fix` 此前遇验证失败会跳过安全迁移，现已修复 |

| `#76860` | Gateway systemd 升级后 operator 添加的 secrets 被清除问题 |

| `#76539` | pnpm v9+ 因 `@whiskeysockets/libsignal-node` 阻断 baileys 安装 |

| `#76910` | LanceDB memory 缺少 `apache-arrow` 运行时依赖导致安装失败 |

| 插件安装覆盖 | `openclaw plugins install discord` 安装一个插件后其他插件消失 |

| Config unset 数组越界 | 删除数组成员时误删后续元素 |

| Control UI 重复派发 | 快速提交按钮触发重复 `agent:main:main` 调用 |

| Google Meet 音频排队 | 音频在 realtime session 未就绪时就排队 |

| Telegram 论坛话题 | Active Memory 在 Telegram 论坛主题中报验证错误 |

| 工具拒绝规则误判 | `tools.deny: [“write”]` 错误地隐式拒绝了 `apply_patch` |

| Embedding 重索引 | Provider 网络抖动导致重索引失败（现已包容瞬态错误） |

—

3️⃣ 是否值得更新？

结论：强烈建议更新。

理由：

– 安全补丁：2026.5.3-1 是专门针对 process.env 访问的安全修复，属于高优先级

– Gateway 性能提升：懒加载机制让启动速度和 Control UI 响应明显变快

– 插件系统重构：解决了长期存在的插件安装后覆盖、依赖丢失问题

– 文件传输是全新能力：这是之前没有的能力，对跨节点操作很有用

—

4️⃣ 安全更新 & 平滑升级操作

安全相关：

– 2026.5.3-1 修复了 bundled 插件包中 process.env 访问的安全漏洞（⚠️ 建议优先升级至此 hotfix）

– 文件传输插件默认路径拒绝 + 符号链接禁止，安全性开箱即用

升级步骤：

# 1. 备份当前配置

openclaw config export ~/openclaw-backup-$(date +%Y%m%d).yaml

# 2. 检查当前状态

openclaw doctor

# 3. 执行升级（推荐升级到最新 hotfix 2026.5.3-1）

openclaw update

# 4. 重启 Gateway 验证

openclaw gateway restartopenclaw doctor --fix   # 自动修复遗留迁移问题

降级方案：

openclaw update --version 2026.4.29openclaw gateway restart