跳到主要内容

ClawHub

ClawHub 是 OpenClaw 的公共 Skills 注册中心 。它是一项免费服务:所有 Skills 都是公开的、开放的,所有人都可以查看、共享和复用。Skills 就是一个包含 SKILL.md 文件(以及辅助文本文件)的文件夹。你可以在网页应用中浏览 Skills,也可以使用 CLI 来搜索、安装、更新和发布 Skills。网站:clawhub.com

ClawHub 网站首页

在 OpenClaw 中的定位

默认情况下,CLI 会将 Skills 安装到当前工作目录下的 ./skills。如果已配置 OpenClaw 工作区,clawhub 会回退到该工作区,除非你通过 --workdir(或 CLAWHUB_WORKDIR)进行覆盖。OpenClaw 从 <workspace>/skills 加载工作区 Skills,并会在下一个 会话中生效。如果你已经在使用 ~/.openclaw/skills 或内置 Skills,工作区 Skills 优先级更高。有关 Skills 加载、共享和权限控制的更多详情,请参阅 Skills

Skills 目录结构

适用人群(新手友好)

如果你想为 OpenClaw 智能体添加新功能,ClawHub 是查找和安装 Skills 的最简单方式。你不需要了解后端的工作原理。你可以:

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

安装 CLI

原版 ClawHub CLI(国际用户)

任选其一:

npm i -g clawhub pnpm add -g clawhub

安装 ClawHub CLI

SkillHub CLI(国内用户推荐)⭐

SkillHub 是 ClawHub 的国内镜像站,专为中国用户优化,提供高速下载体验。访问网站:skillhub.tencent.com

安装方式:

xxxxxxxxxx npm i -g skillhub

SkillHub 网站首页

SkillHub 的优势:

  • 加速下载 :国内高速镜像,无需科学上网
  • 安全审计 :所有 Skills 经过安全检查
  • 数据同步 :收录 ClawHub 生态共 2.2 万个 Skills

SkillHub 精选榜单

SkillHub 镜像站介绍(国内用户)

什么是 SkillHub

SkillHub 是 ClawHub 的国内镜像站,数据来源与 ClawHub 完全一致,但提供了更适合国内用户的服务体验。

核心功能

  1. 精选推荐 :官方精选 TOP 50 AI Skills,一键安装
  2. 高速下载 :国内服务器,下载速度大幅提升
  3. 安全审计 :所有 Skills 都经过安全检查,降低风险
  4. 便捷搜索 :支持中文搜索,快速找到所需技能
  5. 实时同步 :与 ClawHub 数据实时同步,确保最新

使用方式

SkillHub CLI 的使用方式与原版 clawhub 完全一致:

  • 搜索:skillhub search "关键词"
  • 安装:skillhub install <skill-slug>
  • 更新:skillhub update --all
  • 列表:skillhub list

与原版的关系

  • 数据来源 :SkillHub 的数据来自 ClawHub,两者内容一致
  • 命令兼容 :SkillHub 支持所有 clawhub 的命令和参数
  • 安装位置 :同样安装到 ./skills 目录,OpenClaw 自动识别
  • 可切换 :可以同时安装 clawhub 和 skillhub,根据需要使用

登录 ClawHub 账号

为什么要登录

虽然 ClawHub 允许未登录用户搜索和安装 Skills,但登录账号有以下重要好处:

  • 避免限速 :未登录用户可能会遇到下载限速
  • 访问完整功能 :某些高级功能需要登录才能使用
  • 发布 Skills :只有登录用户才能发布自己的 Skills
  • 收藏和评论 :可以收藏喜欢的 Skills 并发表评论
  • 使用统计 :查看自己的使用情况

登录步骤

方法一:通过 GitHub 登录(推荐)

这是最简单、最安全的登录方式。

1.1 访问 ClawHub 官网

在浏览器中打开:https://clawhub.com

访问 ClawHub 官网

1.2 点击登录

点击页面右上角的"Login"或"登录"按钮:

点击登录按钮

1.3 选择 GitHub 登录

在登录页面中,点击"Sign in with GitHub"或"使用 GitHub 登录"。

1.4 授权访问

授权成功后,会自动跳转回 ClawHub,并显示已登录状态。

方法二:使用 Token 登录

如果你无法使用 GitHub 登录,可以使用 Token 方式登录。

2.1 登录账号

首先按照方法一的步骤,通过 GitHub 登录到 ClawHub 官网。

2.2 进入设置页面

登录后,点击页面右上角的用户头像,选择"Settings"或"设置":

进入设置页面

2.3 创建 API Token

在设置页面中,找到"API Tokens"或"API 令牌"部分,点击"Create token"或"创建令牌":

创建 API Token

2.4 复制 Token

系统会生成一个新的 API Token,点击复制按钮复制这个 Token:

复制 Token

⚠️ 重要提示

  • Token 只显示一次,请务必复制并妥善保存
  • 不要将 Token 分享给他人
  • Token 可以随时在设置页面删除
2.5 在终端登录

打开终端,运行以下命令(将 你的Token 替换为刚才复制的 Token):

xxxxxxxxxx clawhub login \--token 你的Token

使用 Token 登录

注意--token 后面有一个空格,然后粘贴你的 Token。

常见问题

问题1:登录提示 Token 无效

错误信息:

xxxxxxxxxx Error: Invalid token

可能原因:

  • Token 复制不完整
  • Token 已过期或被删除
  • 输入时多出空格或字符

解决方案:

  1. 重新创建 Token 并复制
  2. 确保复制时没有多余空格
  3. 检查 Token 是否完整

问题2:GitHub 登录失败

可能原因:

  • 网络连接问题
  • GitHub 账号未验证邮箱
  • 浏览器阻止了重定向

解决方案:

  1. 检查网络连接
  2. 确认 GitHub 账号已验证邮箱
  3. 尝试使用其他浏览器或无痕模式

问题3:登录后仍然限速

可能原因:

  • 登录未生效
  • 使用了错误的 CLI(clawhub vs skillhub)

解决方案:

  1. 运行 clawhub whoami 确认登录状态
  2. 确认使用正确的 CLI 命令
  3. 重新登录

快速入门

使用原版 ClawHub

  1. 安装 CLI(参见上一节)。

  2. 搜索你需要的内容:(国内需要科学上网)

xxxxxxxxxx clawhub search "find"

ClawHub 搜索结果

  1. 安装一个 Skills:

语法:clawhub install <skill-slug>

xxxxxxxxxx clawhub install find 4. 启动一个新的 OpenClaw 会话,以加载新 Skills。

使用 SkillHub(国内用户)

  1. 安装 SkillHub CLI:

xxxxxxxxxx npm i -g skillhub 2. 搜索你需要的内容:

xxxxxxxxxx skillhub search "find" 3. 安装一个 Skills:

语法:skillhub install <skill-slug>

xxxxxxxxxx skillhub install find 4. 启动一个新的 OpenClaw 会话,以加载新 Skills。

智能体常用工作流

搜索 Skills

xxxxxxxxxx clawhub search "postgres backups"

或使用 SkillHub:

xxxxxxxxxx skillhub search "postgres backups"

下载新 Skills

xxxxxxxxxx clawhub install my-skill-pack

或使用 SkillHub:

xxxxxxxxxx skillhub install my-skill-pack

更新已安装的 Skills

xxxxxxxxxx clawhub update --all

或使用 SkillHub:

xxxxxxxxxx skillhub update --all

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

对于单个 Skills 文件夹:

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

一次扫描并备份多个 Skills:

xxxxxxxxxx clawhub sync --all

CLI 命令和参数

全局选项(适用于所有命令):

  • --workdir <dir>:工作目录(默认:当前目录;回退到 OpenClaw 工作区)。
  • --dir <dir>:Skills 目录,相对于工作目录(默认: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

已安装 Skills 列表

发布:

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

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

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

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

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

环境变量

  • CLAWHUB_SITE:覆盖网站 URL。
  • CLAWHUB_REGISTRY:覆盖注册中心 API URL。
  • CLAWHUB_CONFIG_PATH:覆盖 CLI 存储令牌/配置的位置。
  • CLAWHUB_WORKDIR:覆盖默认工作目录。
  • CLAWHUB_DISABLE_TELEMETRY=1:禁用 sync 的遥测功能。

关于ClawHub的更多内容可以参考:ClawHub - OpenClaw