---
read_when:
    - 搜索、安装或更新 Skills 或插件
    - 将 Skills 或插件发布到注册表
    - 配置 clawhub CLI 或其环境覆盖项
sidebarTitle: ClawHub
summary: ClawHub：OpenClaw Skills 和插件的公共注册表、原生安装流程，以及 clawhub CLI
title: ClawHub
x-i18n:
    generated_at: "2026-05-02T19:10:45Z"
    model: gpt-5.5
    provider: openai
    source_hash: cd422cb3e7e53fcc6d2b8a557ebc569debb0b470d5fcf141d90499c03fb4d7b3
    source_path: tools/clawhub.md
    workflow: 16
---

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

- 使用原生 `openclaw` 命令搜索、安装和更新 Skills，并从 ClawHub 安装插件。
- 使用单独的 `clawhub` CLI 处理注册表认证、发布、删除/恢复删除和同步工作流。

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

## 快速开始

<Steps>
  <Step title="搜索">
    ```bash
    openclaw skills search "calendar"
    ```
  </Step>
  <Step title="安装">
    ```bash
    openclaw skills install <skill-slug>
    ```
  </Step>
  <Step title="使用">
    启动一个新的 OpenClaw 会话，它会加载新技能。
  </Step>
  <Step title="发布（可选）">
    对于需要注册表认证的工作流（发布、同步、管理），请安装
    单独的 `clawhub` CLI：

    ```bash
    npm i -g clawhub
    # or
    pnpm add -g clawhub
    ```

  </Step>
</Steps>

## 原生 OpenClaw 流程

<Tabs>
  <Tab title="Skills">
    ```bash
    openclaw skills search "calendar"
    openclaw skills install <skill-slug>
    openclaw skills update --all
    ```

    原生 `openclaw` 命令会安装到你的当前工作区，并
    持久化来源元数据，以便后续 `update` 调用可以继续使用 ClawHub。

  </Tab>
  <Tab title="插件">
    ```bash
    openclaw plugins search "calendar"
    openclaw plugins install clawhub:<package>
    openclaw plugins update --all
    ```

    `plugins search` 会查询 ClawHub 插件目录并输出可直接安装的
    包名称。当你想使用 ClawHub 解析时，请使用 `clawhub:<package>`。
    在发布切换期间，裸 npm 安全插件规格会从 npm 安装：

    ```bash
    openclaw plugins install openclaw-codex-app-server
    ```

    `npm:<package>` 也仅使用 npm，当某个规格可能存在歧义时很有用：

    ```bash
    openclaw plugins install npm:openclaw-codex-app-server
    ```

    插件安装会在归档安装运行前验证声明的 `pluginApi` 和
    `minGatewayVersion` 兼容性，因此不兼容的主机会提前失败关闭，
    而不是部分安装该包。当某个包版本发布 ClawPack 构件时，
    OpenClaw 会优先使用精确上传的 npm-pack `.tgz`，验证 ClawHub
    摘要标头和下载字节，并记录构件类型、npm 完整性、
    npm shasum、tarball 名称和 ClawPack 摘要元数据，以供后续
    更新使用。没有 ClawPack 元数据的旧包版本仍会使用
    旧版包归档验证路径。

  </Tab>
</Tabs>

<Note>
`openclaw plugins install clawhub:...` 只接受可安装的插件
系列。如果某个 ClawHub 包实际是技能，OpenClaw 会停止并
指引你改用 `openclaw skills install <slug>`。

匿名 ClawHub 插件安装也会对私有包失败关闭。
社区或其他非官方渠道仍可安装，但 OpenClaw
会发出警告，以便操作员在启用前审查来源和验证结果。
</Note>

## ClawHub 是什么

- OpenClaw Skills 和插件的公共注册表。
- 技能包和元数据的版本化存储。
- 用于搜索、标签和使用信号的发现界面。

一个典型技能是包含以下内容的版本化文件包：

- 一个 `SKILL.md` 文件，包含主要描述和用法。
- 技能使用的可选配置、脚本或支持文件。
- 标签、摘要和安装要求等元数据。

ClawHub 使用元数据来支持发现，并安全地暴露技能
能力。注册表会跟踪使用信号（星标、下载量）来
改进排序和可见性。每次发布都会创建新的 semver
版本，注册表会保留版本历史，以便用户审计
变更。

## 工作区和技能加载

单独的 `clawhub` CLI 也会把技能安装到当前工作目录下的 `./skills`。
如果已配置 OpenClaw 工作区，`clawhub` 会回退到该工作区，
除非你覆盖 `--workdir`（或 `CLAWHUB_WORKDIR`）。OpenClaw 会从
`<workspace>/skills` 加载工作区技能，并在**下一个**会话中加载它们。

如果你已经使用 `~/.openclaw/skills` 或内置技能，工作区
技能会优先。有关技能如何加载、共享和门控的更多细节，
请参阅 [Skills](/zh-CN/tools/skills)。

## 服务功能

| 功能                  | 说明                                                               |
| ------------------------ | ------------------------------------------------------------------- |
| 公共浏览          | Skills 及其 `SKILL.md` 内容可公开查看。          |
| 搜索                   | 由嵌入驱动（向量搜索），而不仅是关键词。               |
| 版本管理               | Semver、变更日志和标签（包括 `latest`）。                  |
| 下载                | 每个版本一个 zip。                                                    |
| 星标和评论       | 社区反馈。                                                 |
| 安全扫描摘要  | 详情页面会在安装或下载前显示最新扫描状态。 |
| 扫描器详情页面     | VirusTotal、ClawScan 和静态分析结果有深层链接。  |
| 所有者恢复仪表板 | 发布者可以从 `/dashboard` 查看因扫描保留的自有内容。       |
| 所有者请求重新扫描  | 所有者可以请求有限的重新扫描，以恢复误报。     |
| 审核               | 审批和审计。                                               |
| CLI 友好 API         | 适合自动化和脚本。                              |

## 安全和审核

ClawHub 默认开放，任何人都可以上传技能，但 GitHub
账号必须**至少注册一周**才能发布。这样可以减缓
滥用，同时不阻止合法贡献者。

<AccordionGroup>
  <Accordion title="安全扫描">
    ClawHub 会对已发布的技能和插件版本运行自动安全检查。
    公共详情页面会汇总当前结果，扫描器行会链接到
    VirusTotal、ClawScan 和静态分析的专用详情页面。

    被扫描保留或阻止的版本可能无法在公共目录和
    安装界面中使用，但其所有者仍可在 `/dashboard` 中看到。

  </Accordion>
  <Accordion title="举报">
    - 任何已登录用户都可以举报技能。
    - 举报原因是必填项并会被记录。
    - 每个用户最多可同时拥有 20 条活跃举报。
    - 默认情况下，收到超过 3 个唯一举报的 Skills 会被自动隐藏。

  </Accordion>
  <Accordion title="审核">
    - 审核员可以查看隐藏的 Skills、取消隐藏、删除它们，或封禁用户。
    - 滥用举报功能可能导致账号被封禁。
    - 有兴趣成为审核员？请在 OpenClaw Discord 中询问，并联系审核员或维护者。

  </Accordion>
</AccordionGroup>

## ClawHub CLI

你只有在发布/同步等需要注册表认证的工作流中才需要它。

### 全局选项

<ParamField path="--workdir <dir>" type="string">
  工作目录。默认：当前目录；回退到 OpenClaw 工作区。
</ParamField>
<ParamField path="--dir <dir>" type="string" default="skills">
  Skills 目录，相对于工作目录。
</ParamField>
<ParamField path="--site <url>" type="string">
  站点基础 URL（浏览器登录）。
</ParamField>
<ParamField path="--registry <url>" type="string">
  注册表 API 基础 URL。
</ParamField>
<ParamField path="--no-input" type="boolean">
  禁用提示（非交互）。
</ParamField>
<ParamField path="-V, --cli-version" type="boolean">
  打印 CLI 版本。
</ParamField>

### 命令

<AccordionGroup>
  <Accordion title="认证（登录 / 退出 / 我是谁）">
    ```bash
    clawhub login              # browser flow
    clawhub login --token <token>
    clawhub logout
    clawhub whoami
    ```

    登录选项：

    - `--token <token>` — 粘贴 API 令牌。
    - `--label <label>` — 为浏览器登录令牌存储的标签（默认：`CLI token`）。
    - `--no-browser` — 不打开浏览器（需要 `--token`）。

  </Accordion>
  <Accordion title="搜索">
    ```bash
    clawhub search "query"
    ```

    搜索 Skills。对于插件/包发现，请使用 `clawhub package explore`。

    - `--limit <n>` — 最大结果数。

  </Accordion>
  <Accordion title="浏览 / 检查插件">
    ```bash
    clawhub package explore --family code-plugin
    clawhub package explore "episodic-claw" --family code-plugin
    clawhub package inspect episodic-claw
    ```

    `package explore` 和 `package inspect` 是 ClawHub CLI 用于插件/包发现和元数据检查的界面。原生 OpenClaw 安装仍使用 `openclaw plugins install clawhub:<package>`。

    选项：

    - `--family skill|code-plugin|bundle-plugin` — 筛选包系列。
    - `--official` — 仅显示官方包。
    - `--executes-code` — 仅显示执行代码的包。
    - `--version <version>` / `--tag <tag>` — 检查特定包版本。
    - `--versions`, `--files`, `--file <path>` — 检查包历史和文件。
    - `--json` — 机器可读输出。

  </Accordion>
  <Accordion title="安装 / 更新 / 列出">
    ```bash
    clawhub install <slug>
    clawhub update <slug>
    clawhub update --all
    clawhub list
    ```

    选项：

    - `--version <version>` — 安装或更新到特定版本（在 `update` 上仅限单个 slug）。
    - `--force` — 如果文件夹已存在，或本地文件与任何已发布版本不匹配，则覆盖。
    - `clawhub list` 读取 `.clawhub/lock.json`。

  </Accordion>
  <Accordion title="发布 Skills">
    ```bash
    clawhub skill publish <path>
    ```

    选项：

    - `--slug <slug>` — 技能 slug。
    - `--name <name>` — 显示名称。
    - `--version <version>` — semver 版本。
    - `--changelog <text>` — 变更日志文本（可为空）。
    - `--tags <tags>` — 逗号分隔的标签（默认：`latest`）。

  </Accordion>
  <Accordion title="发布插件">
    ```bash
    clawhub package publish <source>
    ```

    `<source>` 可以是本地文件夹、`owner/repo`、`owner/repo@ref`，或
    GitHub URL。

    选项：

    - `--dry-run` — 构建精确的发布计划，不上传任何内容。
    - `--json` — 为 CI 输出机器可读内容。
    - `--source-repo`, `--source-commit`, `--source-ref` — 当自动检测不够时使用的可选覆盖项。

  </Accordion>
  <Accordion title="请求重新扫描">
    ```bash
    clawhub skill rescan <slug>
    clawhub skill rescan <slug> --yes --json

    clawhub package rescan <name>
    clawhub package rescan <name> --yes --json
    ```

    重新扫描命令需要已登录的所有者令牌，并以最新
    已发布技能版本或插件版本为目标。在非交互运行中，传入
    `--yes`。

    JSON 响应包含目标类型、名称、版本、重新扫描状态，以及
    该版本或发布版本的剩余/最大请求次数。

  </Accordion>
  <Accordion title="删除 / 恢复删除（所有者或管理员）">
    ```bash
    clawhub delete <slug> --yes
    clawhub undelete <slug> --yes
    ```
  </Accordion>
  <Accordion title="同步（扫描本地 + 发布新增或更新）">
    ```bash
    clawhub sync
    ```

    选项：

    - `--root <dir...>` — 额外扫描根目录。
    - `--all` — 不提示，上传所有内容。
    - `--dry-run` — 显示将上传的内容。
    - `--bump <type>` — 更新时使用 `patch|minor|major`（默认：`patch`）。
    - `--changelog <text>` — 非交互更新的变更日志。
    - `--tags <tags>` — 逗号分隔的标签（默认：`latest`）。
    - `--concurrency <n>` — 注册表检查并发数（默认：`4`）。

  </Accordion>
</AccordionGroup>

## 常见工作流

<Tabs>
  <Tab title="搜索">
    ```bash
    clawhub search "postgres backups"
    ```
  </Tab>
  <Tab title="查找插件">
    ```bash
    clawhub package explore --family code-plugin
    clawhub package explore "memory" --family code-plugin
    clawhub package inspect episodic-claw
    ```
  </Tab>
  <Tab title="安装">
    ```bash
    clawhub install my-skill-pack
    ```
  </Tab>
  <Tab title="全部更新">
    ```bash
    clawhub update --all
    ```
  </Tab>
  <Tab title="发布单个 skill">
    ```bash
    clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
    ```
  </Tab>
  <Tab title="同步多个 skills">
    ```bash
    clawhub sync --all
    ```
  </Tab>
  <Tab title="从 GitHub 发布插件">
    ```bash
    clawhub package publish your-org/your-plugin --dry-run
    clawhub package publish your-org/your-plugin
    clawhub package publish your-org/your-plugin@v1.0.0
    clawhub package publish https://github.com/your-org/your-plugin
    ```
  </Tab>
</Tabs>

### 插件包元数据

代码插件必须在
`package.json` 中包含所需的 OpenClaw 元数据：

```json
{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./src/index.ts"],
    "runtimeExtensions": ["./dist/index.js"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}
```

已发布的包应附带**已构建的 JavaScript**，并将
`runtimeExtensions` 指向该输出。Git 检出安装在没有已构建文件时仍可回退到 TypeScript 源码，但已构建的运行时入口可避免在启动、doctor 和插件加载路径中进行运行时 TypeScript 编译。

## 版本控制、锁文件和遥测

<AccordionGroup>
  <Accordion title="版本控制和标签">
    - 每次发布都会创建一个新的 **semver** `SkillVersion`。
    - 标签（如 `latest`）指向某个版本；移动标签可让你回滚。
    - 变更日志按版本附加，在同步或发布更新时可以为空。

  </Accordion>
  <Accordion title="本地更改与注册表版本">
    更新会使用内容哈希将本地 skill 内容与注册表版本进行比较。如果本地文件与任何已发布版本都不匹配，CLI 会在覆盖前询问（或在非交互式运行中要求使用 `--force`）。
  </Accordion>
  <Accordion title="同步扫描和回退根目录">
    `clawhub sync` 会先扫描你的当前工作目录。如果没有找到 skills，它会回退到已知的旧版位置（例如 `~/openclaw/skills` 和 `~/.openclaw/skills`）。这旨在无需额外标志即可找到较旧的 skill 安装。
  </Accordion>
  <Accordion title="存储和锁文件">
    - 已安装的 skills 会记录在你工作目录下的 `.clawhub/lock.json` 中。
    - 认证令牌存储在 ClawHub CLI 配置文件中（可通过 `CLAWHUB_CONFIG_PATH` 覆盖）。

  </Accordion>
  <Accordion title="遥测（安装计数）">
    当你在登录状态下运行 `clawhub sync` 时，CLI 会发送一个最小快照来计算安装计数。你可以完全禁用它：

    ```bash
    export CLAWHUB_DISABLE_TELEMETRY=1
    ```

  </Accordion>
</AccordionGroup>

## 环境变量

| 变量                          | 作用                                            |
| ----------------------------- | ----------------------------------------------- |
| `CLAWHUB_SITE`                | 覆盖站点 URL。                                 |
| `CLAWHUB_REGISTRY`            | 覆盖注册表 API URL。                           |
| `CLAWHUB_CONFIG_PATH`         | 覆盖 CLI 存储令牌/配置的位置。                 |
| `CLAWHUB_WORKDIR`             | 覆盖默认工作目录。                             |
| `CLAWHUB_DISABLE_TELEMETRY=1` | 在 `sync` 时禁用遥测。                         |

## 相关

- [社区插件](/zh-CN/plugins/community)
- [插件](/zh-CN/tools/plugin)
- [Skills](/zh-CN/tools/skills)
