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

# ClawHub

# ClawHub

ClawHub 是 **OpenClaw 的公共 Skills 注册中心**。它是一项免费服务：所有 Skills 都是公开的、开放的，所有人都可以查看、共享和复用。Skills 就是一个包含 `SKILL.md` 文件（以及辅助文本文件）的文件夹。你可以在网页应用中浏览 Skills，也可以使用 CLI 来搜索、安装、更新和发布 Skills。 16. 这是一个免费服务：所有技能都是公开、开放，并对所有人可见，便于共享和复用。 17. 一个技能只是一个包含 `SKILL.md` 文件（以及支持性的文本文件）的文件夹。 18. 你可以在 Web 应用中浏览技能，或使用 CLI 来搜索、安装、更新和发布技能。

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

## 20. ClawHub 是什么

* 21. 一个用于 OpenClaw 技能的公共注册表。
* 22. 一个带版本的技能包及其元数据存储库。
* 23. 一个用于搜索、标签和使用信号的发现平台。

## 24. 工作原理

1. 25. 用户发布一个技能包（文件 + 元数据）。
2. 26. ClawHub 存储该技能包，解析元数据，并分配一个版本。
3. 27. 注册表会对技能建立索引，用于搜索和发现。
4. 28. 用户在 OpenClaw 中浏览、下载并安装技能。

## 29) 你可以做什么

* 30. 发布新技能以及现有技能的新版本。
* 31. 按名称、标签或搜索来发现技能。
* Download skill bundles and inspect their files.
* 33. 举报具有滥用性或不安全的技能。
* 34. 如果你是版主，可以隐藏、取消隐藏、删除或封禁。

## 35. 适合谁（对初学者友好）

如果你想为 OpenClaw 智能体添加新功能，ClawHub 是查找和安装 Skills 的最简单方式。你不需要了解后端的工作原理。你可以： 37. 你不需要了解后端是如何工作的。 38. 你可以：

* 使用自然语言搜索 Skills。
* 将 Skills 安装到你的工作区。
* 之后使用一条命令更新 Skills。
* 通过发布 Skills 来备份你自己的 Skills。

## 快速入门（非技术人员）

1. 安装 CLI（参见下一节）。
2. 搜索你需要的内容：
   * `clawhub search "calendar"`
3. 安装一个 Skills：
   * `clawhub install <skill-slug>`
4. 启动一个新的 OpenClaw 会话，以加载新 Skills。

## 安装 CLI

任选其一：

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

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

## 在 OpenClaw 中的定位

默认情况下，CLI 会将 Skills 安装到当前工作目录下的 `./skills`。如果已配置 OpenClaw 工作区，`clawhub` 会回退到该工作区，除非你通过 `--workdir`（或 `CLAWHUB_WORKDIR`）进行覆盖。OpenClaw 从 `<workspace>/skills` 加载工作区 Skills，并会在**下一个**会话中生效。如果你已经在使用 `~/.openclaw/skills` 或内置 Skills，工作区 Skills 优先级更高。 如果配置了 OpenClaw 工作区，`clawhub` 会回退到该工作区，除非你通过 `--workdir`（或 `CLAWHUB_WORKDIR`）进行覆盖。 OpenClaw 会从 `<workspace>/skills` 加载工作区技能，并会在**下一次**会话中生效。 如果你已经使用 `~/.openclaw/skills` 或内置技能，工作区技能具有更高优先级。

有关 Skills 加载、共享和权限控制的更多详情，请参阅
[Skills](/tools/skills)。

## 技能系统概览

技能是一个带版本的文件包，用于教会 OpenClaw 如何执行
特定任务。 每次发布都会创建一个新版本，注册表会保留
版本历史，以便用户审计更改。

一个典型的技能包括：

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

ClawHub 使用元数据来支持发现，并安全地暴露技能能力。
注册表还会跟踪使用信号（例如星标和下载量），以改进
排名和可见性。

## 服务功能

* **公开浏览**Skills 及其 `SKILL.md` 内容。
* 基于嵌入向量（向量搜索）的**搜索**，而不仅仅是关键词匹配。
* 基于 semver 的**版本管理**，包含变更日志和标签（包括 `latest`）。
* 每个版本以 zip 格式**下载**。
* **星标和评论**，支持社区反馈。
* **审核**钩子，用于审批和审计。
* **CLI 友好的 API**，支持自动化和脚本编写。

## 安全与审核

ClawHub 默认是开放的。 任何人都可以上传技能，但用于发布的 GitHub 账号必须
至少创建一周。 这有助于减缓滥用行为，而不会阻止
合法贡献者。

举报与审核：

* 任何已登录用户都可以举报技能。
* 举报原因是必填的，并会被记录。
* 每个用户同时最多可以有 20 个有效举报。
* 拥有超过 3 个不同用户举报的技能将默认被自动隐藏。
* 版主可以查看被隐藏的技能、将其取消隐藏、删除它们，或封禁用户。
* 滥用举报功能可能会导致账号被封禁。

有兴趣成为版主吗？ 请在 OpenClaw Discord 中咨询，并联系一位
版主或维护者。

## CLI 命令和参数

全局选项（适用于所有命令）：

* `--workdir <dir>`：工作目录（默认：当前目录；回退到 OpenClaw 工作区）。
* `--dir <dir>`：Skills 目录，相对于工作目录（默认：`skills`）。
* `--site <url>`：网站基础 URL（浏览器登录）。
* `--registry <url>`：注册中心 API 基础 URL。
* `--no-input`：禁用提示（非交互模式）。
* `-V, --cli-version`：打印 CLI 版本。

认证：

* `clawhub login`（浏览器流程）或 `clawhub login --token <token>`
* `clawhub logout`
* `clawhub whoami`

选项：

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

搜索：

* `clawhub search "query"`
* `--limit <n>`：最大结果数。

安装：

* `clawhub install <slug>`
* `--version <version>`：安装指定版本。
* `--force`：如果文件夹已存在则覆盖。

更新：

* `clawhub update <slug>`
* `clawhub update --all`
* `--version <version>`：更新到指定版本（仅限单个 slug）。
* `--force`：当本地文件与任何已发布版本不匹配时强制覆盖。

列表：

* `clawhub list`（读取 `.clawhub/lock.json`）

发布：

* `clawhub publish <path>`
* `--slug <slug>`：Skills 标识符。
* `--name <name>`：显示名称。
* `--version <version>`：语义化版本号。
* `--changelog <text>`：变更日志文本（可以为空）。
* `--tags <tags>`：逗号分隔的标签（默认：`latest`）。

删除/恢复（仅所有者/管理员）：

* `clawhub delete <slug> --yes`
* `clawhub undelete <slug> --yes`

同步（扫描本地 Skills + 发布新增/更新的 Skills）：

* `clawhub sync`
* `--root <dir...>`：额外的扫描根目录。
* `--all`：无提示上传所有内容。
* `--dry-run`：显示将要上传的内容。
* `--bump <type>`：更新的版本号递增类型 `patch|minor|major`（默认：`patch`）。
* `--changelog <text>`：非交互更新的变更日志。
* `--tags <tags>`：逗号分隔的标签（默认：`latest`）。
* `--concurrency <n>`：注册中心检查并发数（默认：4）。

## Common workflows for agents

### 搜索 Skills

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub search "postgres backups"
```

### 下载新 Skills

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub install my-skill-pack
```

### 更新已安装的 Skills

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub update --all
```

### 备份你的 Skills（发布或同步）

对于单个 Skills 文件夹：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
```

一次扫描并备份多个 Skills：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub sync --all
```

## 高级详情（技术性）

### 版本管理和标签

* 每次发布都会创建一个新的**语义化版本** `SkillVersion`。
* 标签（如 `latest`）指向某个版本；移动标签可以实现回滚。
* 变更日志附加在每个版本上，在同步或发布更新时可以为空。

### 本地更改与注册中心版本

更新时会使用内容哈希将本地 Skills 内容与注册中心版本进行比较。如果本地文件与任何已发布版本不匹配，CLI 会在覆盖前询问确认（或在非交互模式下需要 `--force`）。 If local files do not match any published version, the CLI asks before overwriting (or requires `--force` in non-interactive runs).

### 同步扫描和回退根目录

`clawhub sync` scans your current workdir first. If no skills are found, it falls back to known legacy locations (for example `~/openclaw/skills` and `~/.openclaw/skills`). This is designed to find older skill installs without extra flags.

### 存储和锁文件

* 已安装的 Skills 记录在工作目录下的 `.clawhub/lock.json` 中。
* 认证令牌存储在 ClawHub CLI 配置文件中（可通过 `CLAWHUB_CONFIG_PATH` 覆盖）。

### 遥测（安装计数）

当你在登录状态下运行 `clawhub sync` 时，CLI 会发送一个最小快照用于计算安装次数。你可以完全禁用此功能： You can disable this entirely:

```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`：禁用 `sync` 的遥测功能。