Skip to content

社区插件(第三方包)可为 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

完整的发布契约参见以下页面:

常见问题

安装社区插件后 openclaw plugins 看不到它是什么原因?

检查是否用了正确的来源前缀:ClawHub 插件用 clawhub:&lt;name&gt;,npm 用 npm:&lt;name&gt;。然后运行 openclaw plugins list 确认已安装。如果插件在 ClawHub 上但刚发布,可能还在审核中——审核完成前对所有安装命令隐藏。

我想发布插件但 clawhub package publish 报错“owner 不匹配”怎么办?

确保你的 ClawHub 账号有该 package 的 owner 权限。运行 clawhub package info &lt;package-name&gt; 查看当前 owner 列表。发布时 your-org 必须与 ClawHub 上注册的组织名称完全一致,包括大小写。

不通过 ClawHub,只用 npm 安装别人发布的插件可以吗?

可以。在过渡期内,npm 仍是受支持的直接安装路径,使用 openclaw plugins install npm:&lt;package-name&gt; 即可。但 ClawHub 会提供更丰富的元数据、扫描状态和安装提示,建议优先使用 ClawHub。

相关链接