Moltbot/docs/zh-CN/cli/plugins.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
您想安装或管理进程内 Gateway 插件 您想调试插件加载失败问题	`openclaw plugins` 的 CLI 参考（list、install、enable/disable、doctor）	plugins	generated_at model provider source_hash source_path workflow 2026-02-01T20:21:23Z claude-opus-4-5 pi c6bf76b1e766b912ec30a0101d455151c88f1a778bffa121cdd1d0b4fbe73e1c cli/plugins.md 14

openclaw plugins

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

相关内容：

• 插件系统：插件
• 插件清单 + schema：插件清单
• 安全加固：安全

命令

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 Schema（configSchema，即使为空也需要）。缺失或无效的清单或 schema 会导致插件无法加载，并使配置验证失败。

安装

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 中跟踪）。