OpenClaw 🦞

ClawHub

ClawHub

ClawHub 是 OpenClaw 的 public skill registry。它是一个免费服务：所有 skills 都是 public、open 的，对所有人可见以便分享和重用。Skill 只是一个带有 SKILL.md 文件的文件夹（加上 supporting text files）。你可以在 web app 中浏览 skills 或使用 CLI 搜索、安装、更新和发布 skills。

网站：clawhub.ai

ClawHub 是什么

  • OpenClaw skills 的 public registry。
  • Skill bundles 和 metadata 的 versioned store。
  • Search、tags 和 usage signals 的 discovery surface。

工作原理

  1. 用户发布 skill bundle（files + metadata）。
  2. ClawHub 存储 bundle，解析 metadata，并分配 version。
  3. Registry 索引 skill 用于 search 和 discovery。
  4. 用户浏览、下载和安装 skills 到 OpenClaw。

你可以做什么

  • 发布 new skills 和 existing skills 的 new versions。
  • 通过 name、tags 或 search 发现 skills。
  • 下载 skill bundles 并检查它们的 files。
  • 报告 abusive 或 unsafe 的 skills。
  • 如果你是 moderator，可以 hide、unhide、delete 或 ban。

面向谁（beginner-friendly）

如果你想为你的 OpenClaw agent 添加 new capabilities，ClawHub 是查找和安装 skills 的最简单方式。你不需要知道 backend 如何工作。你可以：

  • 通过 plain language 搜索 skills。
  • 安装 skill 到你的 workspace。
  • 稍后用一个命令更新 skills。
  • 通过发布来 back up 你自己的 skills。

Quick start（non-technical）

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

安装 CLI

选择其一：

npm i -g clawhub

pnpm add -g clawhub

如何融入 OpenClaw

默认情况下，CLI 将 skills 安装到当前工作目录下的 ./skills。如果配置了 OpenClaw workspace，clawhub 回退到该 workspace 除非你 override --workdir（或 CLAWHUB_WORKDIR）。OpenClaw 从 <workspace>/skills 加载 workspace skills 并在下一个session 中 pick up 它们。如果你已经使用 ~/.openclaw/skills 或 bundled skills，workspace skills 优先。

有关 skills 如何加载、共享和 gated 的更多详情，见 Skills。

Skill system overview

Skill 是 versioned bundle of files，教导 OpenClaw 如何执行 specific task。每次 publish 创建 new version，registry 保持 versions history 以便用户可以 audit changes。

典型的 skill 包括：

  • SKILL.md 文件带有 primary description 和 usage。
  • Optional configs、scripts 或 supporting files 由 skill 使用。
  • Metadata 如 tags、summary 和 install requirements。

ClawHub 使用 metadata 来 power discovery 并 safely expose skill capabilities。Registry 还 tracks usage signals（如 stars 和 downloads）以 improve ranking 和 visibility。

服务提供什么（features）

  • Public browsing of skills 和它们的 SKILL.md content。
  • Search powered by embeddings（vector search），不仅仅是 keywords。
  • Versioning with semver、changelogs 和 tags（包括 latest）。
  • Downloads as a zip per version。
  • Stars and comments for community feedback。
  • Moderation hooks for approvals 和 audits。
  • CLI-friendly API for automation 和 scripting。

Security and moderation

ClawHub 默认 open。任何人都可以 upload skills，但 GitHub account 必须至少一周 old 才能 publish。这有助于 slow down abuse 而不 blocking legitimate contributors。

Reporting and moderation：

  • 任何 signed in user 可以 report skill。
  • Report reasons 是 required 和 recorded。
  • 每个用户一次最多可以有 20 active reports。
  • 超过 3 unique reports 的 skills 默认 auto hidden。
  • Moderators 可以 view hidden skills、unhide 它们、delete 它们或 ban users。
  • Abusing the report feature 可能导致 account bans。

有兴趣成为 moderator？在 OpenClaw Discord 中询问并联系 moderator 或 maintainer。

CLI commands and parameters

Global options（适用于所有 commands）：

  • --workdir <dir>：Working directory（默认：current dir；falls back to OpenClaw workspace）。
  • --dir <dir>：Skills directory，relative to workdir（默认：skills）。
  • --site <url>：Site base URL（browser login）。
  • --registry <url>：Registry API base URL。
  • --no-input：Disable prompts（non-interactive）。
  • -V, --cli-version：Print CLI version。

Auth：

  • clawhub login（browser flow）或 clawhub login --token <token>
  • clawhub logout
  • clawhub whoami

Options：

  • --token <token>：Paste an API token。
  • --label <label>：Label stored for browser login tokens（默认：CLI token）。
  • --no-browser：Do not open a browser（requires --token）。

Search：

  • clawhub search "query"
  • --limit <n>：Max results。

Install：

  • clawhub install <slug>
  • --version <version>：Install a specific version。
  • --force：Overwrite if the folder already exists。

Update：

  • clawhub update <slug>
  • clawhub update --all
  • --version <version>：Update to a specific version（single slug only）。
  • --force：Overwrite when local files do not match any published version。

List：

  • clawhub list（reads .clawhub/lock.json）

Publish：

  • clawhub publish <path>
  • --slug <slug>：Skill slug。
  • --name <name>：Display name。
  • --version <version>：Semver version。
  • --changelog <text>：Changelog text（can be empty）。
  • --tags <tags>：Comma-separated tags（默认：latest）。

Delete/undelete（owner/admin only）：

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

Sync（scan local skills + publish new/updated）：

  • clawhub sync
  • --root <dir...>：Extra scan roots。
  • --all：Upload everything without prompts。
  • --dry-run：Show what would be uploaded。
  • --bump <type>：patch|minor|major for updates（默认：patch）。
  • --changelog <text>：Changelog for non-interactive updates。
  • --tags <tags>：Comma-separated tags（默认：latest）。
  • --concurrency <n>：Registry checks（默认：4）。

Agents 的 Common workflows

Search for skills

clawhub search "postgres backups"

Download new skills

clawhub install my-skill-pack

Update installed skills

clawhub update --all

Back up your skills（publish or sync）

对于单个 skill folder：

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

一次性 scan and back up many skills：

clawhub sync --all

Advanced details（technical）

Versioning and tags

  • 每次 publish 创建新的 semver SkillVersion。
  • Tags（如 latest）point to a version；moving tags 让你可以 roll back。
  • Changelogs attached per version 并且可以是 empty when syncing or publishing updates。

Local changes vs registry versions

Updates compare the local skill contents to registry versions using a content hash。如果 local files 不匹配任何 published version，CLI asks before overwriting（或在 non-interactive runs 中 requires --force）。

Sync scanning and fallback roots

clawhub sync 首先扫描你的 current workdir。如果没有找到 skills，它 falls back to known legacy locations（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。这 designed to find older skill installs without extra flags。

Storage and lockfile

  • Installed skills recorded in .clawhub/lock.json under your workdir。
  • Auth tokens stored in the ClawHub CLI config file（override via CLAWHUB_CONFIG_PATH）。

Telemetry（install counts）

当你 logged in 运行 clawhub sync 时，CLI sends a minimal snapshot to compute install counts。你可以完全 disable 这个：

export CLAWHUB_DISABLE_TELEMETRY=1

Environment variables

  • CLAWHUB_SITE：Override the site URL。
  • CLAWHUB_REGISTRY：Override the registry API URL。
  • CLAWHUB_CONFIG_PATH：Override where the CLI stores the token/config。
  • CLAWHUB_WORKDIR：Override the default workdir。
  • CLAWHUB_DISABLE_TELEMETRY=1：Disable telemetry on sync。