跳转至

openclaw plugins

管理 Gateway 插件、hook 包和兼容捆绑包。

插件系统

安装、启用和排查插件问题的最终用户指南。

管理插件

安装、列出、更新、卸载和发布的快速示例。

插件捆绑包

捆绑包兼容性模型。

插件清单

清单字段和配置模式。

安全

插件安装的安全加固。

命令

openclaw plugins list [--enabled] [--verbose] [--json]
openclaw plugins search <query> [--limit <n>] [--json]
openclaw plugins install <path-or-spec> [--link] [--force] [--pin] [--no-enable] [--accept-capabilities] [--acknowledge-install-policy-warning] [--marketplace <source>]
openclaw plugins inspect <id> [--runtime] [--json]
openclaw plugins inspect --all [--runtime] [--json]
openclaw plugins info <id>                    # alias for inspect
openclaw plugins enable <ids...> [--accept-capabilities]
openclaw plugins disable <ids...>
openclaw plugins reload <ids...> [--wait] [--accept-capabilities] [--json]
openclaw plugins uninstall <ids...> [--dry-run] [--keep-files] [--force]
openclaw plugins update <ids-or-npm-specs...> | --all [--dry-run]
openclaw plugins registry [--refresh] [--json]
openclaw plugins doctor [--json]
openclaw plugins init <id> [--name <name>] [--type tool|provider|feature] [--directory <path>]
openclaw plugins build [--root <path>] [--entry <path>] [--check]
openclaw plugins validate [--root <path>] [--entry <path>] [--json]
openclaw plugins pack [--root <path>] [--out <file.tgz>] [--json]
openclaw plugins marketplace entries [--offline] [--feed-profile <name>] [--json]
openclaw plugins marketplace list <source> [--json]
openclaw plugins marketplace refresh [--feed-profile <name>] [--expected-sha256 <sha256>] [--json]

如果需要对缓慢的安装、检查、卸载或注册表刷新进行调查，请运行命令并设置 OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1。该跟踪会将各阶段耗时写入 stderr，并保持 JSON 输出可解析。参见调试。

Note

在 Nix 模式（OPENCLAW_NIX_MODE=1）下，openclaw.json 不可变。install、update、uninstall、enable 和 disable 都会拒绝运行。请在本次安装的 Nix 源中管理这些选择（对于 nix-openclaw 为 programs.openclaw.config 或 instances.<name>.config），然后重新构建。当无需记录新的能力同意时，Reload 仍然可用；它会保留配置和安装状态。参见 agent 优先的快速入门。

Note

捆绑插件随 OpenClaw 一起提供。略多于一半默认启用——主要是模型和语音提供商，以及少数其他插件，例如捆绑的浏览器插件。其他捆绑插件需要显式启用或相关配置。已启用并不意味着当前正在使用。提供商的使用取决于配置和请求。需要身份验证的提供商需要凭据；Microsoft speech 等无需密钥的提供商则不需要。plugins list 中的已启用条目并不意味着该插件正在执行工作。

原生 OpenClaw 插件随附 openclaw.plugin.json，其中包含内联 JSON Schema（configSchema，即使为空）。兼容捆绑包则使用其自身的捆绑包清单。

plugins list 会显示 Format: openclaw 或 Format: bundle。详细的 list/info 输出还会显示捆绑包子类型（agent (Agent Plugins)、codex、claude 或 cursor）以及检测到的捆绑包能力。

插件页面

本页是索引。openclaw plugins 的文档分布在六个页面上，每个页面对应一种读者任务。打开与你任务匹配的页面。

页面 阅读时机
创建插件 你正在搭建、构建、验证或打包插件项目。
安装插件 你正在从 ClawHub、npm、git、路径、归档或市场安装。
列出已安装插件 你想查看已安装清单、发现诊断或插件索引。
卸载和更新插件 你正在移除或重新加载插件，或更新其版本和来源。
检查和诊断插件 你需要插件标识、运行时注册、加载错误或注册表状态。
市场源 你正在浏览、列出或刷新市场或托管的已签名源。

各章节迁移位置

上一版单页文档中的每个章节锚点在此都保留其 id，因此诸如 /cli/plugins#registry 之类的现有链接仍然可以解析。每个条目都指向现在承载该内容的页面。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw