Appearance
社区插件(第三方包)可为 OpenClaw 扩展渠道、工具、provider、hook 等能力,通过 openclaw plugins search "calendar" 在 CLI 搜索,或 openclaw plugins install clawhub:<package> 安装。发布到 ClawHub 需先执行 clawhub package publish your-org/your-plugin --dry-run 验证,之后新 release 在审核完成前对用户隐藏。npm 仍支持直接安装,但 ClawHub 是主要发现和分发入口。
OpenClaw 社区插件:怎么查找和发布第三方扩展
查找插件
在 CLI 中搜索 ClawHub:
bash
openclaw plugins search "calendar"从 ClawHub 安装插件,需使用显式来源前缀:
bash
openclaw plugins install clawhub:<package-name>在过渡期内,npm 仍支持直接安装:
bash
openclaw plugins install npm:<package-name>常用安装、更新、检查和卸载示例见 管理插件。完整的命令参考和来源选择规则见 openclaw plugins 文档。
发布插件
当你希望 OpenClaw 用户能发现并安装你的插件时,请将其发布到 ClawHub。ClawHub 负责实时的包列表、发布历史、扫描状态和安装提示。文档不维护静态的第三方插件目录。
bash
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin发布前,确保插件包含包元数据、插件清单、设置文档和明确的维护人。ClawHub 在创建 release 前会验证 owner 范围、包名、版本、文件大小限制和来源元数据;新 release 在审查和验证完成之前,对正常的安装和下载界面保持隐藏。
发布前对照以下清单检查:
| 要求 | 原因 |
|---|---|
| 已发布到 ClawHub | 用户的 openclaw plugins install 提示需要正常工作 |
| 公开 GitHub 仓库 | 源码审查、问题追踪、透明度 |
| 安装和使用文档 | 用户需要知道如何配置 |
| 活跃维护 | 近期更新或及时响应 issue |
完整的发布契约参见以下页面:
- ClawHub 发布规则 说明 owner、scope、release、审查、包验证和包转移。
- 构建插件 展示插件包结构和首次发布流程。
- 插件清单 定义原生插件清单字段。
常见问题
安装社区插件后 openclaw plugins 看不到它是什么原因?
检查是否用了正确的来源前缀:ClawHub 插件用 clawhub:<name>,npm 用 npm:<name>。然后运行 openclaw plugins list 确认已安装。如果插件在 ClawHub 上但刚发布,可能还在审核中——审核完成前对所有安装命令隐藏。
我想发布插件但 clawhub package publish 报错“owner 不匹配”怎么办?
确保你的 ClawHub 账号有该 package 的 owner 权限。运行 clawhub package info <package-name> 查看当前 owner 列表。发布时 your-org 必须与 ClawHub 上注册的组织名称完全一致,包括大小写。
不通过 ClawHub,只用 npm 安装别人发布的插件可以吗?
可以。在过渡期内,npm 仍是受支持的直接安装路径,使用 openclaw plugins install npm:<package-name> 即可。但 ClawHub 会提供更丰富的元数据、扫描状态和安装提示,建议优先使用 ClawHub。
相关链接
- 插件安装与配置 — 安装、配置、重启和故障排除
- 管理插件 — 命令示例
- ClawHub 发布规则 — 发布和 release 规则