Tools 导读

Plugins 是 OpenClaw 的扩展市场,装一个插件就多一种能力

先跑 `openclaw plugins list` 看看当前已加载了哪些插件,再通过 `openclaw plugins install` 从 npm 或本地文件安装。注意:安装后必须重启 Gateway 才能生效,配置写在 `plugins.entries.<id>.config` 下。

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

Plugins 是 OpenClaw 的扩展市场,装一个插件就多一种能力

先跑 `openclaw plugins list` 看看当前已加载了哪些插件,再通过 `openclaw plugins install` 从 npm 或本地文件安装。注意:安装后必须重启 Gateway 才能生效,配置写在 `plugins.entries.<id>.config` 下。

原文共 12 节,先看 Start Here 路径:/tools/plugin 查看官方原文

第一站

🧰 先想画面:OpenClaw 本体像一个大工具箱,插件是后来加进去的功能盒

有的插件会给它接一个新聊天渠道,有的会给它接一个新模型供应商,有的会给它加一把新工具。

🧱 Core 插件

像出厂自带的功能盒,很多已经跟 OpenClaw 一起装好了。

📦 外部插件

像后来从 npm 或社区装进来的额外零件,不是天生就有。

⭐ 这页最重要的一句

插件不是装饰,它是真的在给 OpenClaw 接新能力。

📌 你现在先不用管什么

先别急着看 SDK。对大多数使用者来说,更重要的是知道怎么装、怎么看有没有生效、怎么关掉。

第二站

🧩 官方说的两种格式,其实是在分“真插件”和“兼容包”

原文把插件分成 Native 和 Bundle。你可以先把它们想成两种来路不同的零件盒。

⚙️

Native

这是真正按 OpenClaw 规则做的插件,能在系统里正式注册能力。

🎁

Bundle

这更像把 Codex、Claude、Cursor 那些格式的包拿进来,再由 OpenClaw 帮你翻译成自己能认的能力。

🧭

对普通用户来说

你装的时候不一定非得区分很细,但要知道:有些是原生的,有些是兼容接入的。

🎯

为什么这重要

因为不同格式的能力边界和信任边界不完全一样。不是都叫“插件”,就完全一回事。

第三站

🛠 装插件的动作,其实非常朴素

原文的 Quick start 看起来简短,但已经把普通用户最需要的动作讲完了。

openclaw plugins list

像先打开工具箱目录,看看现在已经装了哪些功能盒。

openclaw plugins install @openclaw/voice-call

像从 npm 仓库把一个新的功能盒拿回来,放进你的 OpenClaw 身上。

openclaw plugins install ./my-plugin

像你手里已经有一个本地零件盒,直接把它接进来,不必先发到公网。

openclaw gateway restart

像装完新零件后,重新开机,让系统重新点名,确认这个新零件真的挂上去了。

第四站

🗂 配置里的 allow、deny、entries,不是在摆样子,是在决定“哪些零件上电”

插件配置块看着像表格,其实每一项都很直白。

✅ allow

像白名单:只允许这些插件真正接电工作。

⛔ deny

像黑名单:这几个插件就算找到了,也别让它们开机。官方强调 deny 赢,是为了让“别开”优先级更大。

🧩 entries.<id>

像每个插件自己的小控制面板,能单独开关、单独塞配置。

🎈 一句话收住

插件不是“发现了就自动全开”,而是得过几层开关,才真的上电。

第五站

📍 Discovery and precedence 在讲什么?在讲“先去哪里找零件”

原文这一段其实很好懂:OpenClaw 会按顺序去几个地方搜插件,谁先匹配到,谁就先算。

1

先看你显式写的路径

也就是 plugins.load.paths。你都亲手指路了,它当然先去这里找。

2

再看工作区扩展目录

像先找当前项目旁边的插件盒,离你最近的优先。

3

再看全局扩展目录

像去整台机器的共享仓库里找。

4

最后才是 bundled

也就是 OpenClaw 自带的那些。不是最后才重要,而是前面那些更像你自己明确要接的东西。

第六站

🎛 Slots 像“同一个插槽一次只能插一块板子”

原文里的 memorycontextEngine slot 很关键。因为这些不是可以全都一起开的类型。

🧠 memory slot

像记忆模块插槽。一次通常只选一个主要记忆插件来值班。

🧩 contextEngine slot

像上下文装配器插槽。一次只会有一个真正接管“怎么拼上下文”的引擎。

plugins.slots.memory = "none"

像干脆把这个插槽留空,不让任何记忆插件上岗。

📌 这节真正想告诉你

有些插件类别不是“多多益善”,而是“同一插槽只能坐一个”。

最后总结

🎈 把 Plugin 这页压成一句最好记的话

插件就是给 OpenClaw 加新零件,而这整页都在教你怎么把零件找出来、装进去、通上电,还别乱装错装。

如果你下一页只想继续看一页,我建议看 /plugins/building-plugins/plugins/bundles。因为一个是教你自己做零件,一个是教你怎么看兼容包到底算不算原生零件。