> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ClawHub

# ClawHub

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

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

网站：[clawhub.ai](https://clawhub.ai)

## 快速开始

使用 OpenClaw 搜索并安装 Skills：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw skills search "calendar"
openclaw skills install @openclaw/demo
openclaw skills update --all
```

使用 OpenClaw 搜索并安装插件：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm i -g clawhub
# 或
pnpm add -g clawhub
```

## ClawHub 托管的内容

| 类型     | 存储内容                       | 常用命令                                         |
| ------ | -------------------------- | -------------------------------------------- |
| Skills | 包含 `SKILL.md` 及支持文件的版本化文本包 | `openclaw skills install @openclaw/demo`     |
| 代码插件   | 包含兼容性元数据的 OpenClaw 插件包     | `openclaw plugins install clawhub:<package>` |
| 捆绑插件   | 用于 OpenClaw 分发的已打包插件包      | `clawhub package publish <source>`           |

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 用于需要注册表身份验证的操作：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub login
clawhub whoami
clawhub search "postgres backups"
clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0
clawhub package explore --family code-plugin
clawhub package inspect episodic-claw
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub install @openclaw/demo
clawhub update @openclaw/demo
clawhub update --all
clawhub list
```

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

## 发布

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub skill publish <path>
```

常用发布选项：

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub package publish <source>
```

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

代码插件必须在 `package.json` 中包含所需的 OpenClaw 兼容性元数据，其中包括 `openclaw.compat.pluginApi` 和 `openclaw.build.openclawVersion`。有关完整命令参考，请参阅 [CLI](/zh-CN/clawhub/cli)；有关 Skills 元数据，请参阅 [Skills 格式](/clawhub/skill-format)。

## 安全与审核

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

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

已登录用户可以举报 Skills 和软件包。审核员可以查看举报、隐藏或恢复内容，以及封禁滥用行为账户。有关政策和执行详情，请参阅[安全](/zh-CN/clawhub/security)、[安全审计](/clawhub/security-audits)、[审核与账户安全](/clawhub/moderation)和[可接受使用政策](/zh-CN/clawhub/acceptable-usage)。

## 遥测与环境

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export CLAWHUB_DISABLE_TELEMETRY=1
```

实用环境变量覆盖项：

| 变量                            | 作用                   |
| ----------------------------- | -------------------- |
| `CLAWHUB_SITE`                | 覆盖用于浏览器登录的网站 URL。    |
| `CLAWHUB_REGISTRY`            | 覆盖注册表 API URL。       |
| `CLAWHUB_CONFIG_PATH`         | 覆盖 CLI 存储令牌/配置状态的位置。 |
| `CLAWHUB_WORKDIR`             | 覆盖默认工作目录。            |
| `CLAWHUB_DISABLE_TELEMETRY=1` | 禁用安装遥测。              |

有关更深入的参考资料，请参阅[遥测](/clawhub/telemetry)、[HTTP API](/clawhub/http-api)和[故障排除](/clawhub/troubleshooting)。