乐于分享
好东西不私藏

OpenClaw 两周三连更:插件底层这次真重构了

OpenClaw 两周三连更:插件底层这次真重构了

过去两周,OpenClaw 发了三个版本:5.2、5.3、5.5。如果只是修修补补不值得专门写,但这三版背后是同一个大动作——插件层从底层被重构了

这个改动普通用户感知不到,但影响很直接:以前装外部插件靠老旧逻辑,不同机器、不同系统偶发性失效;现在全部切到 npm-first 标准,和系统内置插件用同一套行为模型。


5.2:npm-first 插件体系正式收官

外部插件的安装、更新、doctor 修复、依赖上报、制品元数据,这五个环节以前各有一套逻辑,现在全部统一到 npm-first 体系

效果是:

  • 装插件的逻辑和系统内置插件完全一致,不会出现"这台机器能用、另一台不行"

  • doctor 能正确识别外部插件的依赖问题

  • 插件发布流程更稳,preview 通过的插件不再因为某个 cell 抖动就发不出去

简单说:以前修插件问题的经验,现在可以直接套用了


5.3:文件传输插件正式登场

这是 5.2 重构的直接受益者。

新增了 bundled 文件传输插件,四个核心工具:

  • file_fetch:从 paired node 拉文件到本地

  • dir_list:列出 paired node 上的目录结构

  • dir_fetch:批量拉目录

  • file_write:把文件写回 paired node

安全模型是默认 deny,需 operator 逐节点审批路径权限。

它解决的是真实痛点:以前想从手机往电脑传文件,要么靠 AirDrop/微信文件传输助手,要么靠不稳定的脚本。现在 OpenClaw 自己的 agent 工具就能搞定,而且有明确的权限控制。

要真正用起来,分两步:

第一步:先有配对的 node文件传输插件操作的对象是 paired node——手机、笔记本、服务器、iOS/Android 设备都可以。配对方法是在目标设备上安装 OpenClaw node 并连接到你的 Gateway,然后用 openclaw devices list 审批。

第二步:配置允许访问的路径插件默认 deny,意思是不管传什么文件,agent 先报备,再由你审批。配置示例:

plugins:  entries:    file-transfer:      config:        nodes:          <node-id>:            paths:              - /Users/你的名字/Downloads/              - /Users/你的名字/Desktop/            followSymlinks: false  # 默认拒绝符号链接跟踪

单次传输上限 16MB,超过会报错。大文件建议先压缩再传。

能解决什么问题?比如你在手机拍了张照片,想传到电脑桌面上——以前靠 AirDrop 或者微信文件传输助手,现在直接对小麦说「把手机桌面上的截图传到电脑」,agent 就能搞定,而且路径权限是你定的,不会有越权风险。


5.5:飞书 topic session 修复

飞书上有个问题:第一次消息和后续跟进经常跑进不同的 session,上下文割裂。根因是 topic starter thread ID 没正确注入。

现在修了,在飞书里的对话会保持连贯。


xAI Grok 4.3 支持

5.2 开始正式支持 Grok 4.3。值得注意的点:

  • 标准版 100 万 token 上下文窗口

  • 部分 4.20 变体保留 200 万 token 选项

  • 在 OpenClaw 里配置方式和以往一样,不增加额外成本

对于需要处理大型文档、代码库、长链对话的用户,这个升级是实用向的。


值不值得升?

如果你用插件:建议尽快升级到 5.3 及以上版本,npm-first 修正是核心收益。

如果你在飞书用 OpenClaw:5.5 的 session 修复是真实改善,值得跟。

如果你是 Grok 用户:Grok 4.3 支持是直接可用,切换成本为零。

如果你现在用的是 2026.4.x,可以考虑跳到 2026.5.7(当前稳定版)。之前版本偶发的插件问题大多和这次底层重构有关。


参考来源:GitHub openclaw/openclaw Releases v2026.5.2–v2026.5.7、OpenClaw 官方博客OpenClaw 官方文档 docs.openclaw.ai/plugins/reference/file-transfer