ClawHub

ClawHub 是 OpenClaw 的公共 Skill 注册中心。这是一个免费服务：所有 Skill 都是公开的、开放的，对所有人可见，方便分享和复用。一个 Skill 就是一个包含 SKILL.md 文件（以及其他支持文本文件）的文件夹。你可以在网页应用中浏览 Skill，或使用 CLI 来搜索、安装、更新和发布 Skill。

网站：clawhub.com

适合谁用（新手友好）

如果你想给 OpenClaw Agent 添加新功能，ClawHub 是最简单的方式。你不需要了解后端是怎么工作的。你可以：

  • 用自然语言搜索 Skill。
  • 把 Skill 安装到你的 Workspace。
  • 之后用一条命令更新 Skill。
  • 通过发布来备份你自己的 Skill。

快速开始（非技术向）

  1. 安装 CLI（见下一节）。
  2. 搜索你需要的东西：
    • clawhub search "calendar"
  3. 安装一个 Skill：
    • clawhub install <skill-slug>
  4. 启动一个新的 OpenClaw Session，这样它就能识别新 Skill 了。

安装 CLI

选一个：

npm i -g clawhub
pnpm add -g clawhub

如何融入 OpenClaw

默认情况下，CLI 会把 Skill 安装到当前工作目录下的 ./skills。如果配置了 OpenClaw Workspace，clawhub 会回退到那个 Workspace，除非你用 --workdir（或 CLAWHUB_WORKDIR）覆盖。OpenClaw 从 <workspace>/skills 加载 Workspace Skill，并会在下一个 Session 中识别它们。如果你已经在用 ~/.openclaw/skills 或内置 Skill，Workspace Skill 会优先生效。

关于 Skill 如何加载、共享和控制的更多细节，请看 Skills。

服务提供的功能

  • 公开浏览 Skill 及其 SKILL.md 内容。
  • 搜索功能由 Embeddings（向量搜索）驱动，不只是关键词匹配。
  • 版本管理支持 semver、变更日志和标签（包括 latest）。
  • 下载每个版本的 zip 压缩包。
  • 点赞和评论用于社区反馈。
  • 审核钩子用于审批和审计。
  • CLI 友好的 API 用于自动化和脚本编写。

CLI 命令和参数

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

  • --workdir <dir>：工作目录（默认：当前目录；回退到 OpenClaw Workspace）。
  • --dir <dir>：Skill 目录，相对于 workdir（默认：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 Token。
  • --label <label>：为浏览器登录 Token 存储的标签（默认：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>：Skill slug。
  • --name <name>：显示名称。
  • --version <version>：Semver 版本。
  • --changelog <text>：变更日志文本（可以为空）。
  • --tags <tags>：逗号分隔的标签（默认：latest）。

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

  • clawhub delete <slug> --yes
  • clawhub undelete <slug> --yes

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

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

Agent 的常见工作流

搜索 Skill

clawhub search "postgres backups"

下载新 Skill

clawhub install my-skill-pack

更新已安装的 Skill

clawhub update --all

备份你的 Skill（发布或同步）

对于单个 Skill 文件夹：

clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

一次扫描并备份多个 Skill：

clawhub sync --all

高级细节（技术向）

版本管理和标签

  • 每次发布都会创建一个新的 semver SkillVersion。
  • 标签（如 latest）指向一个版本；移动标签可以让你回滚。
  • 变更日志附加到每个版本，在同步或发布更新时可以为空。

本地更改 vs 注册中心版本

更新时会使用内容哈希将本地 Skill 内容与注册中心版本进行比较。如果本地文件与任何已发布版本都不匹配，CLI 会在覆盖前询问（或在非交互运行时需要 --force）。

同步扫描和回退根目录

clawhub sync 首先扫描你当前的 workdir。如果没找到 Skill，它会回退到已知的旧位置（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。这是为了在不需要额外标志的情况下找到旧的 Skill 安装。

存储和锁文件

  • 已安装的 Skill 记录在你 workdir 下的 .clawhub/lock.json 中。
  • 认证 Token 存储在 ClawHub CLI 配置文件中（通过 CLAWHUB_CONFIG_PATH 覆盖）。

遥测（安装计数）

当你在登录状态下运行 clawhub sync 时，CLI 会发送一个最小快照来计算安装次数。你可以完全禁用它：

export CLAWHUB_DISABLE_TELEMETRY=1

环境变量

  • CLAWHUB_SITE：覆盖网站 URL。
  • CLAWHUB_REGISTRY：覆盖注册中心 API URL。
  • CLAWHUB_CONFIG_PATH：覆盖 CLI 存储 Token/配置的位置。
  • CLAWHUB_WORKDIR：覆盖默认 workdir。
  • CLAWHUB_DISABLE_TELEMETRY=1：在 sync 时禁用遥测。