Cli 导读

插件管理:安装、查看、启用、卸载一条命令搞定

所有插件操作都通过 `openclaw plugins` 子命令完成,最常用的就是 `list`、`install`、`enable`、`disable`、`uninstall`。安装时注意包名先查 ClawHub 再查 npm,`--pin` 只对 npm 有效,`--force` 会覆盖已有安装但不会绕过安全扫描。

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

插件管理:安装、查看、启用、卸载一条命令搞定

所有插件操作都通过 `openclaw plugins` 子命令完成,最常用的就是 `list`、`install`、`enable`、`disable`、`uninstall`。安装时注意包名先查 ClawHub 再查 npm,`--pin` 只对 npm 有效,`--force` 会覆盖已有安装但不会绕过安全扫描。

原文共 14 节,先看 Start Here 路径:/cli/plugins 查看官方原文

第一站

🛒 先记这几个主按钮:看货架、装零件、开关零件、拆零件、修零件

官方开头那组命令,其实就是插件仓库最常见的几个动作。

📋

plugins list

像先看仓库和机身上现在都有哪些零件,哪些已经装好、哪些只是随箱附送但还没通电。

plugins install ...

像把一个新零件从仓库、市场或本地箱子里搬进来。

🔌

enable / disable

像把零件真正接上电,或者先拔掉电源让它别参与工作。

🩺

inspect / doctor / update

像看零件说明书、做体检、换新版本。

第二站

📦 不是所有零件长一样,所以官方才分“原生插件”和“兼容 bundle”

这块看起来术语多,但压成画面很好懂:有的是专门为 OpenClaw 造的零件,有的是别家标准但能装进来的兼容件。

openclaw.plugin.json

像原厂零件盒,上面贴着 OpenClaw 自己的说明标签。

Codex / Claude / Cursor bundles

像兼容配件。虽然不是原厂盒子,但能识别出接口后,也能参与同一套安装流程。

Format: openclaw / bundle

像货架上会先给你贴清楚:这是原厂件,还是兼容件。

Bundled plugins 默认禁用

像机器出厂时随箱送的零件先放在盒子里,得你自己点头再装上电。

第三站

🛍️ install 这一段,像“先去 ClawHub 看货,没有再去 npm,实在不行就搬本地箱子”

官方这段写得长,是因为来源真的很多,但核心顺序很清楚。

🏪

ClawHub first

像先去官方能力商城找,bare package names 也会先去这里看。

📦

npm fallback

ClawHub 没货时,再去 npm 仓库翻箱子。

🧳

local path / archive

像你自己手里就拎着一个本地零件盒,也可以直接装。

📌

一句话

先商城,再仓库,再自己手里的箱子。

第四站

🧷 为什么一直强调 pin、prerelease、integrity?因为这不是贴纸,是会跑起来的零件

这页最应该被认真看待的,不是“怎么装上”,而是“怎么别装歪”。

--pin

像把零件型号钉死,别下次偷偷换成别的版本。

prerelease 要显式点头

像试验版零件不能混进正式仓库,得你自己说“我知道这是 beta/rc,我就是要装”。

integrity hash 变化会警告

像同一个零件盒标签没变,里面重量却变了,系统会停下来问你:“你确定还要装吗?”

Treat plugin installs like running code

官方这句要当真。装插件不只是“多一个按钮”,而是把新代码请进家里。

第五站

🔍 inspect / info 像“把零件翻过来,看它到底有几根线、几种能力、会不会偷偷带挂件”

很多人装完就不看了,其实 inspect 很值得看,因为它会把插件真正注册出来的东西摊平给你看。

🪪

identity / source / load status

像先确认这是谁家的零件、从哪来的、现在有没有真的通电。

🛠️

hooks / tools / commands / services

像看这块零件到底接了哪些线、会动哪些开关、有没有挂服务和路由。

🧬

plain / hybrid / hook-only

像给零件分类:单功能、多功能、只挂钩子、或者不是能力件而是辅助件。

📦

--json

像把整份零件体检单变成机器能继续审计的格式。

第六站

🧹 uninstall / update 像“拆零件”和“换新版零件”

拆和更都不是简单的删目录。官方说明里有很多联动细节。

plugins uninstall <id>

像把零件从记录表、白名单、加载路径里一起摘下来,不只是把盒子扔出门。

--keep-files

像先把电断掉、账删掉,但零件盒子先留在仓库地上。

plugins update --all

像按安装记录给整排零件一起查有没有新版,再逐个换上去。

memory 插件特殊点

如果你拆的是当前正在当记忆槽位的插件,系统会把那个槽位退回 memory-core,像把脑袋里的外挂记忆片先换回原厂片。

最后总结

🎈 把 openclaw plugins 压成一句话

openclaw plugins 就像能力零件仓库和维修台:先看货架,再装或启用新零件,必要时拆掉、升级、验货,还得一直记住这些零件装进来以后真的会开始参与干活。