Plugins 导读

Plugin Inventory 帮你看清每个插件是内置、外部安装，还是只在源码里

这页由 extensions 包信息、openclaw.plugin.json 和 npm package files 规则生成。重点是 Distribution column：included in OpenClaw 的插件已在核心包里，official external package 需要安装，source checkout only 只适合源码环境。

先讲这一页到底在解决什么

Plugin Inventory 帮你看清每个插件是内置、外部安装，还是只在源码里

原文共 6 节，先看 Start Here 路径：/plugins/plugin-inventory 查看官方原文

第一站

三种分发标签先记住

Core npm package

已经包含在 openclaw npm 包里，像买大盒子时自带的小零件。

Official external package

OpenClaw 官方维护，但按需安装，像店里另一个小盒子。

Source checkout only

只在源码仓库里，适合开发和 QA，不要当成公开可安装插件宣传。

第二站

安装前先看标签，别重复装

如果清单说某个插件 included in OpenClaw，普通用户通常不用再安装。外部官方包才需要先 install，然后重启 Gateway。

官方示例

openclaw plugins install @openclaw/discord
openclaw gateway restart
openclaw plugins inspect discord --runtime --json

为什么要重启

安装像把新工具放进柜子，Gateway 重启后才会重新整理柜子并认出新工具。

为什么要 inspect

检查运行时看到的插件，确认不是只“下载了”，而是真的被 OpenClaw 认出来了。

源码 checkout 特别点

开发仓库里，bundled plugins 会从 extensions/<id> 加载，所以本地改动和 workspace 依赖都能被看见。

第三站

inventory 和 reference 的分工

这两页都像清单，但看问题的角度不一样。

Inventory 问

这个插件在哪发、要不要装、是 core 里自带还是外部包？

Reference 问

这个插件的 package 和 manifest 元信息长什么样？

Manifest 问

OpenClaw 运行代码前，需要从这张身份证上读到哪些静态事实？

一句话

inventory 管“货在哪”，reference 管“卡上写什么”，manifest 管“系统先信哪张卡”。

最后记住

这页不是手工维护表格，而是源元数据的镜子

如果清单不对，优先检查插件的 package.json、openclaw.plugin.json、npm files 排除规则，然后重新生成 inventory。不要只改生成结果，那样下次同步会又变回去。