ClawHub

ClawHub 是 OpenClaw Skills 和插件的公共注册表。

• 使用原生 openclaw 命令搜索、安装和更新 Skills，以及从 ClawHub 安装插件。
• 使用单独的 clawhub CLI 进行注册表身份验证、发布以及删除/恢复删除工作流。

网站：clawhub.ai

快速开始

使用 OpenClaw 搜索并安装 Skills：

openclaw skills search "calendar"openclaw skills install @openclaw/demoopenclaw skills update --all

使用 OpenClaw 搜索并安装插件：

openclaw plugins search "calendar"openclaw plugins install clawhub:<package>openclaw plugins update --all

当需要发布或删除/恢复删除等需注册表身份验证的工作流时，安装 ClawHub CLI：

npm i -g clawhub# 或pnpm add -g clawhub

ClawHub 托管的内容

ClawHub 跟踪语义化版本、latest 等标签、变更日志、文件、下载量、星标数和安全扫描摘要。公共页面会显示注册表的当前状态，以便用户在安装 Skills 或插件前进行检查。

原生 OpenClaw 工作流

原生 OpenClaw 命令会将内容安装到当前 OpenClaw 工作区，并持久保存来源元数据，使后续更新命令能够继续使用 ClawHub。

当插件安装需要通过 ClawHub 解析时，请使用 clawhub:<package>。在发布切换期间，符合 npm 安全规范的裸插件规格可能通过 npm 解析；当必须明确指定来源时，npm:<package> 仍仅使用 npm。

插件安装会在执行归档安装前，验证声明的 pluginApi 和 minGatewayVersion 兼容性。当软件包版本发布 ClawPack 工件时，OpenClaw 会优先使用上传的精确 npm-pack .tgz，验证 ClawHub 摘要标头和下载的字节，并记录工件元数据以供后续更新使用。

ClawHub CLI

ClawHub CLI 用于需要注册表身份验证的操作：

clawhub loginclawhub whoamiclawhub search "postgres backups"clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0clawhub package explore --family code-pluginclawhub package inspect episodic-clawclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-plugin

该 CLI 还提供 Skills 安装/更新命令，用于直接操作注册表：

clawhub install @openclaw/democlawhub update @openclaw/democlawhub update --allclawhub list

这些命令会将 Skills 安装到当前工作目录下的 ./skills，并在 .clawhub/lock.json 中记录已安装的版本。

发布

从包含 SKILL.md 的本地文件夹发布 Skills：

clawhub skill publish <path>

常用发布选项：

• --slug <slug>：已发布 Skills 的 URL 名称。
• --name <name>：显示名称。
• --version <version>：语义化版本。
• --changelog <text>：变更日志文本。
• --tags <tags>：以逗号分隔的标签，默认为 latest。

从本地文件夹、owner/repo、owner/repo@ref 或 GitHub URL 发布插件：

clawhub package publish <source>

使用 --dry-run 构建精确的发布计划而不上传，并使用 --json 获取适合 CI 的输出。

代码插件必须在 package.json 中包含所需的 OpenClaw 兼容性元数据，其中包括 openclaw.compat.pluginApi 和 openclaw.build.openclawVersion。有关完整命令参考，请参阅 CLI；有关 Skills 元数据，请参阅 Skills 格式。

安全与审核

ClawHub 默认开放：任何人都可以上传，但发布者必须使用注册时间达到上传门槛要求的 GitHub 账户。公共详情页面会在安装或下载前汇总最新扫描状态。

ClawHub 会对已发布的 Skills 和插件版本执行自动检查。因扫描而暂缓或被阻止的版本可能会从公共目录和安装界面中消失，但其所有者仍可在 /dashboard 中看到这些版本。

已登录用户可以举报 Skills 和软件包。审核员可以查看举报、隐藏或恢复内容，以及封禁滥用行为账户。有关政策和执行详情，请参阅安全、安全审计、审核与账户安全和可接受使用政策。

遥测与环境

登录后运行 clawhub install 时，CLI 可能会尽力发送安装事件，以便 ClawHub 计算汇总安装量。可通过以下方式禁用：

export CLAWHUB_DISABLE_TELEMETRY=1

实用环境变量覆盖项：

有关更深入的参考资料，请参阅遥测、HTTP API和故障排除。