English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

快速开始

管理插件

大多数插件工作流只需要几个命令：搜索、安装、重启 Gateway 网关、 验证，并在你不再需要该插件时卸载。

列出插件

bash
openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --json

对脚本使用 --json。当插件包声明了 dependencies 或 optionalDependencies 时，它会包含注册表诊断信息以及每个插件的 静态 dependencyStatus。

bash
openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list 是一次冷库存检查。它会显示 OpenClaw 能从配置、 清单和插件注册表中发现的内容；它不能证明已经运行中的 Gateway 网关进程 已导入该插件运行时。

安装插件

bash
# Search ClawHub for plugin packages.openclaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.openclaw plugins install <package> # Force one source.openclaw plugins install clawhub:<package>openclaw plugins install npm:<package> # Install a specific version or dist-tag.openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@betaopenclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # Install from git or a local development checkout.openclaw plugins install git:github.com/acme/[email protected]openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

安装插件代码后，重启为你的渠道提供服务的 Gateway 网关：

bash
openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

当你需要证明插件已注册运行时表面，例如工具、钩子、服务、Gateway 网关方法， 或插件拥有的 CLI 命令时，使用 inspect --runtime。

更新插件

bash
openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --all

如果插件是从 npm dist-tag（例如 @beta）安装的，后续的 update <plugin-id> 调用会复用记录的该标签。传入显式 npm spec 会将跟踪的安装切换到该 spec，以供未来更新使用。

bash
openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

当插件之前固定到精确版本或标签时，第二个命令会把插件移回注册表的默认发布线。

当 openclaw update 在 beta 频道上运行时，默认线 npm 和 ClawHub 插件记录会先尝试匹配的插件 @beta 版本。如果该 beta 版本不存在， OpenClaw 会回退到记录的默认/latest spec。对于 npm 插件，当 beta 包存在但安装验证失败时，OpenClaw 也会回退。精确版本和显式标签（例如 @rc 或 @beta）会被保留。

卸载插件

bash
openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-filesopenclaw gateway restart

卸载会移除插件的配置条目、插件索引记录、允许/拒绝列表条目，以及适用时的 链接加载路径。除非你传入 --keep-files，否则托管安装目录会被移除。

在 Nix 模式（OPENCLAW_NIX_MODE=1）下，插件安装、更新、卸载、启用和禁用命令 都会被禁用。请改为在该安装的 Nix 源中管理这些选择；对于 nix-openclaw， 请使用以 agent 优先的 快速开始。

发布插件

你可以将外部插件发布到 ClawHub、npmjs.com，或 两者都发布。

发布到 ClawHub

ClawHub 是 OpenClaw 插件的主要公共发现表面。它会在安装前为用户提供 可搜索的元数据、版本历史和注册表扫描结果。

bash
npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

用户可以通过以下方式从 ClawHub 安装：

bash
openclaw plugins install clawhub:<package>openclaw plugins install <package>

裸形式仍会先检查 ClawHub。

发布到 npmjs.com

原生 npm 插件必须包含插件清单和 package.json OpenClaw 入口点元数据。

package.json
{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}
bash
npm publish --access public

用户可以通过以下方式安装仅 npm 的插件：

bash
openclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/[email protected]

如果同一个包也可在 ClawHub 上获取，npm: 会跳过 ClawHub 查找并 强制使用 npm 解析。

来源选择

  • ClawHub：当你需要 OpenClaw 原生发现、扫描摘要、版本和安装提示时使用。
  • npmjs.com：当你已经发布 JavaScript 包，或需要 npm dist-tags/私有注册表工作流时使用。
  • Git：当你想直接从分支、标签或提交安装时使用。
  • 本地路径：当你在同一台机器上开发或测试插件时使用。

相关内容

Was this useful?