本页内容

本页内容

CLI 命令

插件 CLI

openclaw plugins

管理网关插件、钩子包和兼容捆绑包。

当网关运行时,安装、卸载、启用、禁用和重新加载使用其现有的网关路由。地方后备措施需要独家的线下国家所有权。在运行 plugins update、plugins registry --refresh、市场源刷新或 hook-pack 安装回退之前,通过其服务所有者停止网关。 plugins marketplace entries --offline 读取保存的提要而不刷新它。拒绝的命令报告如何重试。

当插件或配置操作正在运行时,CLI 仅在网关确认其不接受突变时才会等待并重试。入场费用保持在司令部现有的十分钟预算范围内,包括 plugins reload --wait。中断该命令会取消待处理的准入重试。一个已经被接受的突变可能仍然会完成;在重试之前检查插件状态。丢失回复和接受后失败会报告,但不会自动重播;在重试之前检查插件状态。不提供准入事实的旧网关保留显式忙响应。

如果命令遇到数据库离线维护,则报告原因,但不带 OPENCLAW_DEBUG。等待维护完成,然后重试该命令。

plugins enable 和 plugins disable 接受不区分大小写的插件 ID,包括当网关停止时。报告的 ID 保留其明显拼写;配置中的插件策略键使用所需的小写形式。相同的策略适用于实时激活和下一次网关启动。运行时 ID 和网关方法名称保留插件声明的拼写。

命令

bash
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 inspectopenclaw 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]

对于缓慢的安装、检查、卸载或 registry-refresh 排查,请使用 OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1 运行命令。该跟踪会将各阶段耗时写入 stderr,并保持 JSON 输出可解析。参见 调试。

插件页面

此页是一个索引。 openclaw plugins 共六页,每个读者作业一页。打开与您的任务匹配的页面。

页面 读它的时候
作者插件 您正在创建、构建、验证或打包插件项目。
安装插件 您将从 ClawHub、npm、git、路径、存档或市场进行安装。
列出已安装的插件 您需要安装的清单、发现诊断或插件索引。
卸载和更新插件 您正在删除或重新加载插件,或更新其版本和源。
检查和诊断插件 您需要插件标识、运行时注册、加载错误或注册表状态。
市场供稿 您正在浏览、列出或刷新市场或托管签名源。

各部分移动的地方

以前的单页版本中的每个部分锚点都会在此处保留其 id,因此现有链接(例如 /cli/plugins#registry)仍然可以解析。每个条目都指向现在保存内容的页面。

相关内容

本页有帮助吗?