乐于分享
好东西不私藏

上周我劝你别升 OpenClaw 5.2,这周我改主意了

上周我劝你别升 OpenClaw 5.2,这周我改主意了

事情是这样的。

上周我刚写完 5.2 的踩坑文,建议大伙儿先别急着升。结果评论区直接炸了——有人升完 WhatsApp 收不到消息,有人 macOS 上进程被杀到自闭,还有人飞书模块每十秒崩一次,简直比上班还准时。

我当时的表情就是你想象的那样。

本来想着 5.2 大概要苟一阵子,结果 OpenClaw 团队这波动作快得离谱——v2026.5.3 直接端上来了,而且是带三个新功能、填四个大坑的那种。

这次不是小修小补,是实打实的大版本。

我的建议也很直接:5.3可以升了,不用再等了。

另外又有个5.4版本,我建议不要先更新!后面会讲。


_01_先看看 5.2 踩过的坑填了没

聊新功能之前,得先把 5.2 的历史遗留问题说清楚。毕竟很多人还在观望,就是被 5.2 搞出 PTS D 了。

直接上对照表,一目了然。

5.2 坑 症状 5.3 状态
macOS 进程自杀
重启 LaunchAgent 时把刚拉起来的新进程踢掉
✅ 已修复
WhatsApp 收不到消息
pnpm v9 把 git tarball 依赖挡在门外
✅ 已修复
Gateway env 被清空
升级时运营商自定义环境变量被抹掉
✅ 已修复
doctor –fix 不彻底
有 plugin 缺失就停住不动了
✅ 已修复
飞书模块崩溃
SDK 函数路径变更,每 10 秒重试一次
✅ 已修复
kimi-claw 渠道无声消失
manifest 校验变严,第三方插件被挡
⚠️ 手动处理
SIGKILL 超时
systemd 超时和关闭耗时不匹配
⚠️ 不改也没事

六个 regression 问题,四个在 5.3 里直接修掉了,飞书那个在 beta 阶段就已经搞定。

剩下两个——第三方渠道 manifest 和 SIGKILL 超时,严格来说不算 5.3 该背的锅。manifest 是插件作者自己的事,SIGKILL 看到新进程正常起来就行了,不用慌。

一句话总结:5.2 的大坑基本填平,可以放心升级了。

_02_/steer 命令:长任务终于不是黑箱了

先聊这次我最喜欢的一个功能。

/steer。翻译成人话:AI 跑任务跑到一半,你想插嘴说句话,不用等它跑完。

之前跑长 Agent 任务的体验是什么样的呢?

你丢一个需求下去,AI 吭哧吭哧开始干。跑了十分钟,你发现方向偏了。但你能怎么办?要么干等它跑完,要么强行中断重新来。就跟外卖点错了只能等送到再退一样,憋屈得要命。

现在有了 /steer,就可以在任务执行过程中直接给 AI 一个方向修正。

好比开车的时候副驾说「下个路口左转」,司机听到了但没有停车。AI 会在下一个「运行边界」调整行为——把当前函数写完、把这条消息处理完,然后在自然断点处拐弯。不会在代码写到一半的时候突然抽风转向。

以前跑长任务就像点外卖后手机没信号,只能祈祷骑手别迷路。
现在可以打电话纠正方向了。

配套还有一个 /side 命令,作用是旁路提问。你在主任务里跑着,突然想查点东西、问个问题,用 /side 发出去,不会污染主会话的上下文。适合那种「等等我突然想确认一下这个 API 的参数」的场景。

这两个命令的价值在哪儿呢?我觉得是解决了 Agent 应用里一个最根本的信任问题——长任务不再是一个黑箱了。你在里面干什么我看得见,我有意见随时可以说。有了这个,我才敢把真正重要的长任务交给 AI 去跑。


_03_文件传输:从「字符串糊弄」到「正经快递柜」

第二个新功能,是文件传输插件正式上线。

你可能会说:文件传输有什么好激动的?

但做过多节点协作的人就知道,以前全靠字符串拼接来传数据——一个节点抓完数据,塞进 stdout 里传给下一个节点。数据歪了处理节点就崩,处理节点崩了输出节点就发空报告,整个链条跟多米诺骨牌一样。

5.3 直接内置了一套文件传输工具集,四个命令:

命令 作用
file_fetch
从配对节点拉取文件
dir_fetch
拉取整个目录
dir_list
查看目录内容
file_write
向配对节点写入文件

这套机制我愿称之为「快递柜模式」——谁发的、谁收的、走哪个柜子、东西多重、有没有校验,全都清清楚楚。出了错直接定位到具体环节,不用猜。

安全策略也比较硬核:

① 默认拒绝。 系统不会随意允许读写文件,需要操作员明确确认。你想进我家门?先敲门再说。

② 路径受限。 只能在规定文件夹内活动,越界访问直接被拦。想偷看「公司财务.xlsx」?门都没有。

③ 单次 16MB 上限。 超过的直接拒绝,防止一次性搬走大量数据。

软链接也不跟踪,安全性考虑得很细致。

这意味着什么呢?多节点协作从「理论可行」变成了「工程可用」——一个节点抓数据、一个节点处理、一个节点输出报告,三条流水线,数据流通畅。


_04_流式输出统一化:一处配置,所有平台生效

第三个更新看起来没那么起眼,但做运营的人看完应该会懂。

以前各平台的流式输出配置,散落在各自的 section 里。改一个平台漏一个,是常有的事。改完 Discord 忘了 Teams,改完 Telegram 忘了 Slack,每次部署都像在玩扫雷。

5.3 加了一个统一的配置项:streaming.mode: “progress”

一处配置,直接覆盖 Discord、Telegram、Matrix、Slack、Teams 全部平台。所有平台共用同一套「进度草稿」逻辑。

改动虽然不大,但用过的人都知道这种统一配置有多香。少了一个半夜爬起来修配置的理由,挺好的。


_05_插件系统从「野生动物园」升级成「正规养殖场」

这次 5.3 对插件系统的改动,我愿称之为划时代。

之前装插件的体验是什么样的呢?npm 装到一半报错、版本冲突像宫斗剧、来源不明像地摊货、一更新就炸锅像拆盲盒。每次装个新插件都要深呼吸做心理建设。

5.3 几刀下去,直接砍出了新秩序:

① 官方 npm 包优先。 安装插件优先走经过验证的官方包,来源靠谱。

② ClawHub 兜底。 官方仓库作为后备方案,质量有保证。

③ 拒绝源码包。 不再允许随意扔压缩包安装,系统直接拒绝。以前那种「从犄角旮旯下个 zip 就装」的野路子,被堵死了。

④ 依赖状态可视化。 每个插件的底层依赖和版本清晰列出,谁依赖谁、用的什么版本,一目了然。

⑤ 自动修复。 依赖损坏时自动尝试重装或回滚到上一个稳定版本,不用手动去翻 node_modules 了。

装个插件现在就是一行命令的事:

openclaw plugins install @openclaw/discord

然后重启 Gateway,搞定。

从「在雷区跳踢踏舞」变成「在正规场地散步」,这体验提升不是一个量级的。


_06_多平台通信增强:每个平台都在变好

消息渠道这块的改进比较零散,但各个平台都有实打实的变化。

平台 5.3 改进
Discord
新增状态反馈表情 ✅=完成 ⏳=进行中,相当于进度条
Telegram
降噪处理 + 顺序控制,自动合并重复消息
WhatsApp
支持频道推送,结果可发到群组或广播频道
Slack / Teams / Matrix
修复连接超时、消息截断、格式错乱等老毛病

这里面我觉得最有价值的,是 Discord 的状态反馈。用户能看到 AI 在做什么,比 AI 做得多快还重要——你不知道它在干嘛,就会觉得它挂了。就像等电梯不显示楼层,你会觉得它永远不来。


_07_Gateway 性能:更快了,也更稳了

性能方面也有实打实的数据提升。

5.2 版本三次 CLI 往返需要 11.6 秒,5.3 降到了 10.3 秒。模型响应时间从 2.9~6.6 秒收窄到 2.3~3.7 秒——不只是快了,波动也小了。

背后是更多的惰性加载策略——用的时候才加载,不用就不加载。插件发现、定时任务、会话管理、数据模式都做了优化。

数据不骗人,这波优化是实打实的。


_08_升级建议:5.3 可以升了,选个周末动手

上次我在 5.2 的文章里建议「先别升,等一等」。这次不一样了。

5.3 出了,那个建议可以撤了。

但我也不是说今天就得动手。选个周末不忙的时间,按这个流程走:

① 备份。 先备份 ~/.openclaw/openclaw.json,这是最基本的保险。

② 升级。 运行 openclaw update,一键搞定。

③ 检查。 升级完第一件事是跑 openclaw doctor,看看有没有需要修复的旧配置。

# 升级命令 openclaw update # 或者用 npm npm install -g openclaw@latest

如果你是重度自定义插件用户,额外注意一下:检查每个第三方渠道的 manifest 里有没有 channels 声明,没有的话手动补上。这个 5.3 帮不了你,得自己动手。

如果你还在 5.1 或更早的版本,直接走正常流程升级就行,不需要跳版本。


写在最后

回顾这次更新,六项核心能力闭环了:能控、能传、能装、能发、能修、能限。

能控 —— /steer 随时插手长任务
能传 —— 文件传输用正规 API,不靠 stdout 糊弄
能装 —— 插件从野生动物变成养殖场
能发 —— 多渠道消息不丢不乱不重复
能修 —— doctor 自动修复各种小毛病
能限 —— DNS 和代理范围锁死,防止乱跑

系统只有在可控、可传、可修、可交付、可限制这五件事都做到位,才算真正进入工程级阶段。5.3 这波,是把地基打牢了。

我还是那个感觉:OpenClaw 正在从一个「能跑的玩具」变成「能用在生产环境里干活」的工具。每一步更新都不是花里胡哨的新功能,而是把基础能力一个一个补齐。

上次你升 5.2 了吗?还是一直苟在旧版?这次 5.3 准备什么时候动手?评论区聊聊。

大时代啊,朋友们。