OpenClaw ClawHub公共Skills注册中心实战全攻略

ClawHub

ClawHub 本质上就是 OpenClaw 的 公共 Skills 注册中心，而且完全免费。它背后遵循一个简单透明的原则：所有 Skills 公开、开放，任何人都能查看、共享、复用。你不需要了解复杂协议或后台机制——说白了，Skills 就是一个包含 SKILL.md 文件（再加一些辅助文本）的文件夹。既可以在网页应用里浏览，也可以直接用 CLI 搜索、安装、更新甚至发布自己的 Skills。直接访问官网 clahub.com 即可。

适用人群（新手友好）

什么样的人会真正用到 ClawHub？核心用户就是那些想给 OpenClaw 智能体添加新功能，但又不愿意碰后端代码的人。你可以用自然语言搜索自己想要的 Skills，一条命令安装到工作区，之后还能像升级手机应用一样更新它们。如果自己写了一套好用的 Skills，通过发布到 ClawHub 也相当于做了备份——一举两得。

快速入门（非技术人员）

整个流程非常直接：

1. 第一步是安装 CLI（具体看下面一节）。
2. 然后搜索你需要的东西，比如 clawhub search "calendar"。
3. 找到中意的，一个 clawhub install 就装上了。
4. 最后重开一个新的 OpenClaw 会话，新 Skills 就会自动加载进来。

安装 CLI

安装方式二选一：要么 npm i -g clawhub，要么 pnpm add -g clawhub。

在 OpenClaw 中的定位

默认情况下，CLI 把 Skills 安装到当前工作目录下的 ./skills。如果你已经配置了 OpenClaw 工作区，clawhub 会回退到该工作区——除非通过 --workdir 或 CLAWHUB_WORKDIR 强制指定目录。OpenClaw 从 /skills 加载工作区 Skills，但要注意，这个生效是在下一个会话。如果你已经在用 ~/.openclaw/skills 或内置 Skills，工作区 Skills 的优先级更高。至于加载、共享和权限控制这些细节，参考 Skills 文档更稳妥。

服务功能

ClawHub 提供了不少实用的功能：公开浏览所有 Skills 及其 SKILL.md 内容；基于嵌入向量的搜索，不是简单的关键词匹配，相关度更高；版本管理支持语义化版本号、变更日志和标签（比如 latest）；每个版本以 zip 格式下载；还有星标和评论机制，方便社区反馈。审核钩子用于审批和审计，CLI 友好的 API 更是为自动化脚本而生。

CLI 命令和参数

全局选项对所有命令都适用：

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

下面按功能分组列出常用的命令和参数：

认证

• clawhub login（浏览器流程）或 clawhub login --token
• clawhub logout
• clawhub whoami
• 选项：--token （粘贴 API 令牌）、--label （浏览器令牌存储标签，默认 CLI token）、--no-browser（不打开浏览器，需配合 --token）。

搜索

• clawhub search "query"
• 可选：--limit 控制最大结果数。

安装

• clawhub install
• 可选：--version （指定版本）、--force（文件夹已存在时覆盖）。

更新

• clawhub update 或 clawhub update --all
• 可选：--version （仅单个 slug）、--force（本地文件不匹配时强制覆盖）。

列表

• clawhub list（读取 .clawhub/lock.json）

发布

• clawhub publish
• 参数：--slug （标识符）、--name （显示名称）、--version （语义化版本号）、--changelog （变更日志，可为空）、--tags （逗号分隔标签，默认 latest）。

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

• clawhub delete --yes
• clawhub undelete --yes

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

• clawhub sync
• 选项：--root （额外扫描根目录）、--all（无提示上传全部）、--dry-run（预览上传内容）、--bump （版本递增类型：patch|minor|major，默认 patch）、--changelog （非交互更新的变更日志）、--tags （逗号分隔标签，默认 latest）、--concurrency （注册中心检查并发数，默认4）。

智能体常用工作流

搜索 Skills

clawhub search "postgres backups"

下载新 Skills

clawhub install my-skill-pack

更新已安装的 Skills

clawhub update --all

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

单个 Skills 文件夹：

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

一次扫描并备份多个 Skills：

clawhub sync --all

高级详情（技术性）

版本管理和标签

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

本地更改与注册中心版本

更新时 CLI 会使用内容哈希比较本地 Skills 与注册中心版本的差异。如果本地文件与任何已发布版本都不匹配，CLI 在覆盖前会要求确认（非交互模式下需要加 --force）。

同步扫描和回退根目录

clawhub sync 会先扫描当前工作目录。要是没找到 Skills，它会回退到旧版默认位置（比如 ~/openclaw/skills 和 ~/.openclaw/skills）。这种设计避免了额外标志参数，让旧版 Skills 也能被轻松找到。

存储和锁文件

已安装的 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 的遥测功能。

ClawHub - OpenClaw

来源：互联网