ClawHub

ClawHub 是OpenClaw 的公共技能注册表。它是一项免费服务：所有技能都是公开的、开放的，每个人都可以看到以进行共享和重用。技能只是一个带有 SKILL.md 文件的文件夹（加上支持的文本文件）。你可以在 Web 应用中浏览技能，或使用 CLI 搜索、安装、更新和发布技能。

网站：clawhub.ai

什么是 ClawHub

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

它是如何工作的

  1. 用户发布技能包（文件 + 元数据）。
  2. ClawHub 存储包，解析元数据，并分配版本。
  3. 注册表为搜索和发现索引技能。
  4. 用户在 OpenClaw 中浏览、下载和安装技能。

你可以做什么

  • 发布新技能和现有技能的新版本。
  • 按名称、标签或搜索发现技能。
  • 下载技能包并检查其文件。
  • 报告滥用或不安全的技能。
  • 如果你是版主，可以隐藏、取消隐藏、删除或封禁。

这是给谁的（适合初学者）

如果你想为你的 OpenClaw 代理添加新功能，ClawHub 是查找和安装技能的最简单方法。你不需要知道后端是如何工作的。你可以：

  • 用自然语言搜索技能。
  • 将技能安装到你的工作区。
  • 以后用一个命令更新技能。
  • 通过发布来备份你自己的技能。

快速开始（非技术）

  1. 安装 CLI（见下一节）。
  2. 搜索你需要的东西：
    • clawhub search "calendar"
  3. 安装技能：
    • clawhub install <skill-slug>
  4. 启动新的 OpenClaw 会话以便它获取新技能。

安装 CLI

选择一个：

npm i -g clawhub
pnpm add -g clawhub

它如何融?OpenClaw

默认情况下，CLI 将技能安装到当前工作目录下的 ./skills。如果配置了 OpenClaw 工作区，clawhub 会回退到该工作区，除非你覆?--workdir（或 CLAWHUB_WORKDIR）。OpenClaw ?<workspace>/skills 加载工作区技能，并将?*下一?*会话中获取它们。如果你已经使用 ~/.openclaw/skills 或捆绑技能，工作区技能优先?

有关技能如何加载、共享和门控的更多详细信息，见技能?

技能系统概?

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

一个典型的技能包括：

  • 一?SKILL.md 文件，包含主要描述和使用说明?
  • 技能使用的可选配置、脚本或支持文件?
  • 元数据，如标签、摘要和安装要求?

ClawHub 使用元数据来支持发现并安全地公开技能能力。注册表还跟踪使用信号（如星级和下载）以提高排名和可见性?

服务提供的功能（特性）

  • 公共浏览技能及?SKILL.md 内容?
  • 搜索由嵌入（向量搜索）驱动，不仅仅是关键词?
  • 版本控制带有 semver、变更日志和标签（包?latest）?
  • 下载每个版本?zip 文件?
  • **星级和评?*用于社区反馈?
  • 审核钩子用于审批和审计?
  • CLI 友好?API 用于自动化和脚本?

安全和审?

ClawHub 默认是开放的。任何人都可以上传技能，?GitHub 账户必须至少有一周才能发布。这有助于在不阻止合法贡献者的情况下减缓滥用?

报告和审核：

  • 任何登录用户都可以报告技能?
  • 必须提供报告原因并记录?
  • 每个用户一次最多可以发?20 个活动报告?
  • 拥有超过 3 个唯一报告的技能默认自动隐藏?
  • 版主可以查看隐藏的技能、取消隐藏、删除或封禁用户?
  • 滥用报告功能可能导致账户被封禁?

有兴趣成为版主？?OpenClaw Discord 中询问并联系版主或维护者?

CLI 命令和参?

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

  • --workdir <dir>：工作目录（默认：当前目录；回退?OpenClaw 工作区）?
  • --dir <dir>：技能目录，相对于工作目录（默认：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>：技?slug?
  • --name <name>：显示名称?
  • --version <version>：Semver 版本?
  • --changelog <text>：变更日志文本（可以为空）?
  • --tags <tags>：逗号分隔的标签（默认：latest）?

删除/取消删除（仅所有?管理员）?

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

同步（扫描本地技?+ 发布新的/更新的）?

  • clawhub sync
  • --root <dir...>：额外扫描根目录?
  • --all：无需提示上传所有内容?
  • --dry-run：显示将上传的内容?
  • --bump <type>：patch|minor|major 用于更新（默认：patch）?
  • --changelog <text>：非交互式更新的变更日志?
  • --tags <tags>：逗号分隔的标签（默认：latest）?
  • --concurrency <n>：注册表检查（默认?）?

代理的常见工作流

搜索技?

clawhub search "postgres backups"

下载新技?

clawhub install my-skill-pack

更新已安装的技?

clawhub update --all

备份你的技能（发布或同步）

对于单个技能文件夹?

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

一次扫描和备份多个技能：

clawhub sync --all

高级细节（技术）

版本控制和标?

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

本地更改 vs 注册表版?

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

同步扫描和回退根目?

clawhub sync 首先扫描当前工作区。如果未找到技能，它会回退到已知的旧位置（例如 ~/openclaw/skills ?~/.openclaw/skills）。这是为了在没有额外标志的情况下找到旧的技能安装?

存储和锁文件

  • 已安装的技能记录在工作区下?.clawhub/lock.json 中?
  • 认证令牌存储?ClawHub CLI 配置文件中（通过 CLAWHUB_CONFIG_PATH 覆盖）?

遥测（安装计数）

当你登录时运?clawhub sync，CLI 会发送最小快照以计算安装计数。你可以完全禁用它：

export CLAWHUB_DISABLE_TELEMETRY=1

环境变量

  • CLAWHUB_SITE：覆盖网?URL?
  • CLAWHUB_REGISTRY：覆盖注册表 API URL?
  • CLAWHUB_CONFIG_PATH：覆?CLI 存储令牌/配置的位置?
  • CLAWHUB_WORKDIR：覆盖默认工作区?
  • CLAWHUB_DISABLE_TELEMETRY=1：在 sync 上禁用遥测?