CLI reference for `openclaw plugins` (list, install, enable/disable, doctor)

Read when…
  • You want to install or manage in-process Gateway plugins
  • You want to debug plugin load failures

openclaw plugins

管理网关插件/扩展（进程内加载）。

相关文档：

命令

openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all

捆绑插件随 OpenClaw 发货但默认处于禁用状态。使用 plugins enable 来激活它们。

所有插件必须附带一个 openclaw.plugin.json 文件，其中包含内联 JSON 架构 (configSchema，即使为空）。缺失或无效的清单或架构会阻止插件加载并导致配置验证失败。

安装

openclaw plugins install <path-or-spec>

安全注意事项：将插件安装视为运行代码。建议使用固定版本。

支持的归档格式：.zip，.tgz，.tar.gz，.tar。

使用 --link 避免复制本地目录（添加到 plugins.load.paths）：

openclaw plugins install -l ./my-plugin

更新

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run

更新仅适用于从 npm 安装的插件（在 plugins.installs 中跟踪）。