openclaw plugins¶
管理 Gateway 插件、钩子包和兼容捆绑包。
plugins enable 和 plugins disable 接受不区分大小写的插件 ID,
包括 Gateway 停止时。报告的 ID 保留其清单拼写;配置中的插件
策略键使用规范小写形式。
该策略同样适用于实时激活和下一次 Gateway 启动。运行时
ID 和 Gateway 方法名保留插件声明的拼写。
安装、启用和排查插件问题的最终用户指南。
安装、列出、更新、卸载和发布的快速示例。
捆绑包兼容性模型。
清单字段和配置模式。
插件安装的安全加固。
命令¶
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 源中管理这些选择(programs.openclaw.config,或 nix-openclaw 的 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 之类的现有链接仍可解析。每个条目
指向现在承载该内容的页面。
- 创建
- 功能脚手架和产物
- 提供者脚手架
- 安装
- 配置包含和无效配置修复
--force确认以及重装与更新--pin范围--acknowledge-install-policy-warning- ClawHub 安全审计
- 钩子包和 npm 规范
- Git 仓库
- 归档
- 市场简写
- 市场源
- 远程市场规则
- 列出
--enabled--verbose--json- 插件索引
- 重新加载
- 卸载
- 更新
- 解析插件 ID 与 npm 规范
- Beta 通道更新
- 现有插件来源选择
- 版本检查和完整性漂移
- 更新时的
--acknowledge-install-policy-warning - 更新时的 ClawHub 安全审计
- 检查
- Doctor
- 注册表
- 市场
相关¶
- 构建插件
- CLI 参考
- ClawHub
- ClawHub CLI - 独立注册表命令
- ClawHub 发布 - 所有者、作用域和发布审核
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw