插件管理（安装/更新/卸载/发布）

概述

OpenClaw 插件的日常管理操作：搜索、安装、更新、卸载和发布。支持 ClawHub、npm、git 和本地路径四种来源。

核心要点

安装来源选择：

• ClawHub：OpenClaw 原生发现，扫描摘要，版本历史，安装提示
• npmjs.com：已有 JS 包或需要 npm dist-tag/私有注册表工作流
• Git：直接从分支、tag 或 commit 安装
• 本地路径：同机器开发或测试

裸包名解析顺序： 先尝试 ClawHub，再回退到 npm

plugins list 说明：

• 冷清单检查，显示 OpenClaw 从配置、manifest 和插件注册表可发现的内容
• 不证明已运行的 Gateway 进程已导入插件运行时

inspect --runtime 用途：

• 证明插件已注册运行时表面（工具、钩子、服务、Gateway 方法、CLI 命令）

Nix 模式限制：

• OPENCLAW_NIX_MODE=1 时，安装/更新/卸载/启用/禁用命令被禁用

配置/使用

列出插件：

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

安装插件：

openclaw plugins install clawhub:<package>        # ClawHub
openclaw plugins install npm:@scope/plugin@1.2.3  # npm 精确版本
openclaw plugins install git:github.com/acme/plugin@v1.0.0  # git
openclaw plugins install ./my-plugin              # 本地目录
openclaw plugins install --link ./my-plugin       # 本地链接

更新插件：

openclaw plugins update <plugin-id>
openclaw plugins update --all

卸载插件：

openclaw plugins uninstall <plugin-id> --dry-run
openclaw plugins uninstall <plugin-id>
openclaw plugins uninstall <plugin-id> --keep-files
openclaw gateway restart

发布到 ClawHub：

npm i -g clawhub
clawhub login
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin

发布到 npm（package.json 关键字段）：

{
  "name": "@acme/openclaw-plugin",
  "type": "module",
  "openclaw": { "extensions": ["./dist/index.js"] }
}

相关页面

• concepts/plugin-inventory — 插件清单（核心包 vs 外部包）
• concepts/plugin-building — 创建插件包
• concepts/plugin-manifest — Manifest 和包元数据
• concepts/plugin-dependency-resolution — 依赖解析机制