ClawdHub

ClawdHub 是 OpenClaw 的公共 Skill 注册中心。这是一个免费服务：所有 Skill 都是公开的,任何人都可以查看、分享和复用。一个 Skill 就是一个包含 SKILL.md 文件(以及其他辅助文本文件)的文件夹。你可以在网页上浏览 Skill,或者用 CLI 来搜索、安装、更新和发布 Skill。

网站：clawdhub.com

适合谁用(新手友好)

如果你想给 OpenClaw Agent 添加新功能,ClawdHub 是最简单的方式。你不需要懂后端怎么工作,就可以:

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

快速开始(非技术向)

  1. 安装 CLI(见下一节)。
  2. 搜索你需要的功能:
    • clawdhub search "calendar"
  3. 安装一个 Skill:
    • clawdhub install <skill-slug>
  4. 启动一个新的 OpenClaw Session,它就会加载新 Skill。

安装 CLI

选一个:

npm i -g clawdhub
pnpm add -g clawdhub

如何与 OpenClaw 配合

默认情况下,CLI 会把 Skill 安装到当前工作目录下的 ./skills。如果配置了 OpenClaw Workspace,clawdhub 会回退到那个 Workspace,除非你用 --workdir(或 CLAWDHUB_WORKDIR)覆盖。OpenClaw 从 <workspace>/skills 加载 Workspace Skill,会在下一个 Session 中生效。如果你已经在用 ~/.clawdbot/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 版本。

认证:

  • clawdhub login(浏览器流程)或 clawdhub login --token <token>
  • clawdhub logout
  • clawdhub whoami

选项:

  • --token <token>: 粘贴 API Token。
  • --label <label>: 浏览器登录 Token 的标签(默认:CLI token)。
  • --no-browser: 不打开浏览器(需要 --token)。

搜索:

  • clawdhub search "query"
  • --limit <n>: 最多返回多少结果。

安装:

  • clawdhub install <slug>
  • --version <version>: 安装指定版本。
  • --force: 如果文件夹已存在就覆盖。

更新:

  • clawdhub update <slug>
  • clawdhub update --all
  • --version <version>: 更新到指定版本(仅单个 slug)。
  • --force: 当本地文件与任何已发布版本都不匹配时强制覆盖。

列表:

  • clawdhub list(读取 .clawdhub/lock.json)

发布:

  • clawdhub publish <path>
  • --slug <slug>: Skill 的 slug。
  • --name <name>: 显示名称。
  • --version <version>: Semver 版本号。
  • --changelog <text>: 变更日志文本(可以为空)。
  • --tags <tags>: 逗号分隔的标签(默认:latest)。

删除/恢复(仅所有者/管理员):

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

同步(扫描本地 Skill + 发布新的/更新的):

  • clawdhub sync
  • --root <dir...>: 额外的扫描根目录。
  • --all: 不提示,上传所有内容。
  • --dry-run: 显示会上传什么,但不实际上传。
  • --bump <type>: 更新时的版本号增量:patch|minor|major(默认:patch)。
  • --changelog <text>: 非交互更新时的变更日志。
  • --tags <tags>: 逗号分隔的标签(默认:latest)。
  • --concurrency <n>: 注册中心检查的并发数(默认:4)。

Agent 常见工作流程

搜索 Skill

clawdhub search "postgres backups"

下载新 Skill

clawdhub install my-skill-pack

更新已安装的 Skill

clawdhub update --all

备份你的 Skill(发布或同步)

发布单个 Skill 文件夹:

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

一次扫描并备份多个 Skill:

clawdhub sync --all

高级细节(技术向)

版本管理和标签

  • 每次发布都会创建一个新的 semver SkillVersion。
  • 标签(比如 latest)指向某个版本;移动标签可以实现回滚。
  • 变更日志附加在每个版本上,同步或发布更新时可以为空。

本地修改 vs 注册中心版本

更新时会用内容哈希比较本地 Skill 内容和注册中心版本。如果本地文件与任何已发布版本都不匹配,CLI 会在覆盖前询问(或在非交互模式下需要 --force)。

同步扫描和回退根目录

clawdhub sync 首先扫描你的当前 workdir。如果没找到 Skill,会回退到已知的旧位置(比如 ~/openclaw/skills 和 ~/.clawdbot/skills)。这样设计是为了不用额外参数就能找到旧的 Skill 安装。

存储和锁文件

  • 已安装的 Skill 会记录在你 workdir 下的 .clawdhub/lock.json 中。
  • 认证 Token 存储在 ClawdHub CLI 配置文件中(可通过 CLAWDHUB_CONFIG_PATH 覆盖)。

遥测(安装统计)

当你登录后运行 clawdhub sync 时,CLI 会发送一个最小快照来统计安装次数。你可以完全禁用这个功能:

export CLAWDHUB_DISABLE_TELEMETRY=1

环境变量

  • CLAWDHUB_SITE: 覆盖网站 URL。
  • CLAWDHUB_REGISTRY: 覆盖注册中心 API URL。
  • CLAWDHUB_CONFIG_PATH: 覆盖 CLI 存储 Token/配置的位置。
  • CLAWDHUB_WORKDIR: 覆盖默认 workdir。
  • CLAWDHUB_DISABLE_TELEMETRY=1: 禁用 sync 时的遥测。