欢迎光临
我们一直在努力

OpenClaw 2026.10.8 的插件三本账:文档说核心包自带 75 个,npm 包里只有 66 个,本机 72 个里 39 个加载

OpenClaw 2026.10.8 的插件三本账:文档说核心包自带 75 个,npm 包里只有 66 个,本机 72 个里 39 个加载

截至 2026-10-28 14:00(+08:00),OpenClaw 在 npm 上的 latest 仍是 2026.10.8,发布于 2026-10-27T11:24:29Z。本文在 macOS 26.6.2 / node v24.22.1 上,用 openclaw 2026.10.8 (dc2523e) 实测,把「插件到底有多少个」这件事拆成三本互相对不上的账:文档清单、npm 包内容、本机运行时。

结论先放这里:同一个「OpenClaw 自带插件」概念,文档写 75 个,npm 包里只有 66 个能加载,本机运行时能看见 72 个、其中 39 个处于加载状态。 三组数字没有一组是笔误,它们分别按不同口径统计。

三本账对照

账本 统计口径 数字
文档 /plugins/plugin-inventory 页面自报条目 75 核心包 + 101 官方外部 + 3 仅源码 = 179
npm 包 openclaw@2026.10.8 dist/extensions 下可加载插件 67 个目录,66 个插件
本机运行时 openclaw plugins list --json 72 个(66 内置 + 6 外部),39 个已加载

三本账的差距集中在两处:文档说有 9 个插件「包含在 OpenClaw 里」,而这台机器上最新正式版的包里找不到它们;本机比包内多出 6 个外部安装的插件,其中 2 个版本号还停在 2026.10.7。

怎么数的

  • 文档侧:抓取 https://docs.openclaw.ai/plugins/plugin-inventory 的正文,按小节解析列表条目,统计每节的条目数和去重后的插件 id。
  • 包侧:直接看 /Users/kevin/.npm-global/lib/node_modules/openclaw/dist/extensions 的目录数,再逐个确认是否存在插件清单;同时用 openclaw plugins inspect <id> 验证运行时能否识别。
  • 运行时:openclaw plugins list --json 输出 126 KB JSON,逐项读取 enabled、status、origin、version,以及 toolNames、channelIds、providerIds 等能力字段。

三次测量都在 2026-10-28 14:02 至 14:06(+08:00)之间完成,命令和 URL 可复现。

账本一:文档 179 条,其中 101 条自报却只挂了 100 个参考链接

文档页把插件分成三类,每类都在标题下写了总数:

  • Core npm package:75 plugins,每条都标注 included in OpenClaw(已包含在核心包内)。
  • Official external packages:101 plugins,安装方式写 npm or ClawHub。
  • Source checkout only:3 plugins,只有源码仓库里有。

页面底部的「How this page is built」写明了生成方式:从 extensions/*/openclaw.plugin.json 清单和根 npm 包的 files 排除规则生成,重新生成命令是 pnpm plugins:inventory:gen。也就是说,这张清单不是手写的宣传页,而是从源码清单自动产出的。

一个可以复现的小瑕疵:官方外部包这一节自称 101 条,实际 101 个列表项里只有 100 个指向 /plugins/reference/<id> 参考页。唯一的例外是 parallel,它链到 /tools/parallel-search,而不是自己的参考页。这不影响安装,但说明「101」这个数字和「100 个参考页」之间差了一条链接。

docs.openclaw.ai/plugins/plugin-inventory 「Core npm package」一节写着 75 plugins,下面逐条列出 a2a、active-memory 等插件,均标注 included in OpenClaw

账本二:npm 包里 67 个目录,只有 66 个是插件

dist/extensions 下有 67 个目录,但 image-generation-core 里只有 package.json 和 runtime-api.js/runtime-api.d.ts,没有 openclaw.plugin.json——它是被其他插件引用的运行时模块,不是可加载插件。所以 67 个目录对应 66 个插件,正好等于 openclaw plugins list 里的内置数量。

把文档的 75 条核心清单和本机 66 个内置插件做差集,缺的正好是 9 个:


advisor, agent-guidance, autoreview, bifrost, knowledge,
mcp-events, mcp-relay, omlx, requesty

这 9 个 id 在本机逐个执行 openclaw plugins inspect,全部返回同一句 Plugin not found,并提示用 openclaw plugins list 查看已安装插件。同时,这 9 个 id 在文档站上都有自己的 /plugins/reference/<id> 页面,返回 200。

更有意思的是 plugins search 的结果。openclaw plugins search advisor 只找到一条 ClawHub 插件:


openclaw-advisor-plugin  code-plugin | community | v0.1.3 — OpenClaw advisor plugin for model-agnostic second opinions

这是社区包,名字和文档里的官方 advisor(@openclaw/advisor)不是同一个东西。也就是说,文档说「自带」,包说「没有」,搜索给的是「另一个社区实现」。

docs.openclaw.ai/plugins/plugin-inventory 「Official external packages」一节写着 101 plugins,条目安装方式为 npm 或 ClawHub

反方向的差集是 6 个:deepseek、duckduckgo、feishu、firecrawl、tavily 这 5 个都在文档的官方外部包清单里,属于正常安装;剩下的 feishu-bot-chat(版本 0.2.0)在文档的三类清单里都查不到,只在 ClawHub 生态里存在。

账本三:本机 72 个插件,39 个加载,33 个禁用

openclaw plugins list --json 的输出里,plugins 数组 72 条,enabled 为真的是 39 条,status 字段也正好是 loaded 39 条、disabled 33 条。两个 registry 层的 diagnostics 都是空数组,说明没有插件加载报错——33 个禁用是配置结果,不是加载失败。

按能力字段统计,这 72 个插件声明的表面积如下:

能力 声明该能力的插件数 其中已启用 条目总数
频道 channelIds 5 1 5
模型提供商 providerIds 23 22 27
工具 toolNames 15 7 77
命令 commands 12 3 12
语音 speechProviderIds 9 8 12
向量 embeddingProviderIds 5 4 5

三个值得注意的点:

  1. 频道插件 5 个只开了 1 个。 声明频道的插件是 a2a、reef、telegram、x、feishu,只有 feishu 是启用状态。前四个不是坏了,是被禁用。
  2. 77 个工具声明,只有 29 个随启用插件生效。 单是 workboard 一个插件就声明了 38 个工具(workboard_list、workboard_claim、workboard_dispatch 等),占全部工具声明的 49%,而它处于禁用状态。换句话说,本机「工具很多」和「工具能用」之间差着一半以上。
  3. 三个已加载插件没有任何能力声明。 active-memory、document-extract、feishu-bot-chat 的工具、频道、提供商、命令、服务、钩子字段全是空的。它们仍然被标为 loaded,是否在运行时通过未声明的方式起作用,这份清单回答不了。

版本号有四种写法

72 条记录的 version 字段只有四种取值:

  • 2026.10.8:66 个,与核心包版本一致。
  • 空值:3 个——active-memory(已启用)、device-pair、talk-voice。
  • 2026.10.7:2 个——duckduckgo、firecrawl,都是 ~/.openclaw/extensions 下的外部构建产物。
  • 0.2.0:1 个——feishu-bot-chat,走 npm 项目目录安装的第三方插件。

后两组说明一件事:核心升到 2026.10.8 之后,外部插件不会自动跟着升。两个搜索类插件仍以 2026.10.7 的构建产物在 2026.10.8 的运行时里加载,插件清单上不会报错,只是版本列写着旧号。第三方插件用完全不同的版本方案(0.2.0),和核心版本号无法直接比较新旧。

终端实测:openclaw plugins inspect advisor 返回 Plugin not found,openclaw plugins search advisor 只给出社区插件 openclaw-advisor-plugin v0.1.3

对使用者意味着什么

  1. 把 openclaw plugins list 当作唯一账本。 文档清单是产品目录,回答「这个产品有哪些插件」;plugins list 回答「这台机器上现在有什么」。两者不是同一件事,评估能力前先看后者。
  2. 文档里的「included in OpenClaw」不等于本机可用。 本次实测有 9 个标注自带的 id 在最新正式版包里不存在,inspect 直接报 Plugin not found。要用就先 inspect,别按文档写配置。
  3. 升级后核对版本列,不只看核心版本号。 核心升到 2026.10.8,两个外部插件还停在 2026.10.7;version 为空的插件连新旧都判断不了。
  4. 启用插件才等于拿到能力。 77 个工具声明里 29 个可用,5 个频道插件里 1 个可用;禁用状态下工具名和频道名都不会出现在运行时清单里。

未知项

  • 文档站由源码清单生成,可能描述的是比 npm latest 更新的分支。本次无法从页面本身证明 75 条核心清单对应哪个提交,因此「9 个插件缺失」是版本差还是发布遗漏,UNKNOWN。
  • 这 9 个 id 是否会在后续正式版补齐,UNKNOWN。
  • active-memory 等零声明插件是否通过未声明路径产生运行时效果,UNKNOWN;本清单只能证明它们没有声明能力字段。
  • 33 个禁用插件里,有多少是产品默认关闭、多少是本机配置主动关闭,UNKNOWN;本次只读取了结果状态,没有回溯配置变更历史。

数据来源与更新时间

  • 本机实测:openclaw 2026.10.8 (dc2523e),macOS 26.6.2 (arm64),node v24.22.1;测量时间 2026-10-28 14:02–14:06 +08:00。
  • 命令:openclaw --version、openclaw plugins list --json、openclaw plugins list --enabled --json、openclaw plugins inspect <id>、openclaw plugins search advisor。
  • 包路径:/Users/kevin/.npm-global/lib/node_modules/openclaw/dist/extensions(67 个目录)。
  • 文档:https://docs.openclaw.ai/plugins/plugin-inventory (抓取于 2026-10-28 14:03 +08:00);生成方式见该页「How this page is built」一节。
  • npm 版本与发布时间:npm view openclaw version / npm view openclaw time,latest = 2026.10.8,2026-10-27T11:24:29Z。
  • 本文数据为单机单版本快照,不代表其他安装方式、其他平台或其他版本的结果。
赞(0)
未经允许不得转载:时间网 » OpenClaw 2026.10.8 的插件三本账:文档说核心包自带 75 个,npm 包里只有 66 个,本机 72 个里 39 个加载

更好的WordPress主题

支持快讯、专题、百度收录推送、人机验证、多级分类筛选器,适用于垂直站点、科技博客、个人站,扁平化设计、简洁白色、超多功能配置、会员中心、直达链接、文章图片弹窗、自动缩略图等...

联系我们联系我们

登录

找回密码

注册