openclaw plugins 负责插件和扩展能力管理。当你开始接插件型渠道，或者需要额外扩展 OpenClaw 的能力边界时，这组命令就会变得重要。
什么时候你会真正用到它
最典型的几个场景是：
- 安装某个插件型渠道
- 查看当前系统里已经有哪些插件
- 判断插件有没有被正确安装
- 升级或迁移后确认插件层是否仍然完整
例如某些版本下，飞书插件可能是内置的，也可能需要显式安装。这时 plugins 就不是可选知识，而是排障入口。
为什么它不是新手第一课
因为如果基础链路还没跑通，插件层只会增加变量。更好的节奏通常是：
- 先跑通 Gateway
- 先跑通模型
- 先跑通一个基础渠道
- 再处理插件和扩展能力
这样一旦出问题，你更容易判断到底是核心系统问题，还是插件问题。
常用命令
查看插件列表：
bash
openclaw plugins list --json
安装插件：
bash
openclaw plugins install <plugin-name>
例如飞书插件的典型安装方式：
bash
openclaw plugins install @openclaw/feishu
plugins list --json 为什么值得常用
因为它最适合做“当前系统到底认到了哪些插件”的事实确认。你可以用它回答：
- 这个插件到底装没装上
- 当前环境里有哪些可用插件
- 升级后插件是否还在
很多时候，问题不在渠道配置，而是在插件根本没进系统。
插件层最常见的问题
1. 以为插件内置，但当前版本并没有
不同版本或不同安装方式下，某些插件可能并不是默认存在的，所以先看 plugins list --json 会很重要。
2. 插件装上了，但渠道还是不可用
这时候要分开看：
- 插件安装是否成功
- 渠道凭据是否正确
- Gateway 是否正在运行
不要把“插件已安装”和“渠道已配置成功”当成同一件事。
3. 一上来就把很多插件同时装进去
这会让排障边界迅速变乱。更好的做法是一项一项加，装完就验证。
一个推荐习惯
只要你涉及插件型渠道或扩展能力，就先跑一次：
bash
openclaw plugins list --json
把“系统认没认到插件”这个最基础的问题先回答清楚，再去改配置，会省很多时间。