openclaw plugins

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

相关链接�?

• 插件系统：Plugins
• 插件清单 + 架构：Plugin manifest
• 安全加固：Security

命令

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

捆绑插件�?OpenClaw 一起提供，但默认禁用。使�?plugins enable 激活它们�?

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

安装

openclaw plugins install <path-or-spec>
openclaw plugins install <npm-spec> --pin

安全注意：将插件安装视为运行代码。优先使用固定版本�?

npm 规格**仅限注册�?*（包名称 + 可选版�?标签）。Git/URL/文件规格被拒绝。依赖安装为安全起见使用 --ignore-scripts 运行�?

支持的归档：.zip、.tgz、.tar.gz、.tar�?

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

openclaw plugins install -l ./my-plugin

�?npm 安装上使�?--pin 将解析的精确规格（name@version）保存到 plugins.installs，同时保持默认行为不固定�?

卸载

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files

uninstall �?plugins.entries、plugins.installs、插件允许列表和链接�?plugins.load.paths 条目中删除插件记录。对于活动的内存插件，内存槽重置�?memory-core�?

默认情况下，卸载还会删除活动状态目录扩展根目录下的插件安装目录（$OPENCLAW_STATE_DIR/extensions/<id>）。使�?--keep-files 将文件保留在磁盘上�?

--keep-config 作为 --keep-files 的已弃用别名受支持�?

更新

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

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

当存在存储的完整性哈希且获取的工件哈希发生变化时，OpenClaw 会打印警告并在继续之前请求确认。在 CI/非交互式运行中使用全局 --yes 跳过提示�?