乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > ClawHub 安装教程,OpenClaw Skills 必装工具!

ClawHub 安装教程,OpenClaw Skills 必装工具!

当前时间： 2026-03-12 09:37:02 分类：办公文件 评论(0)
ClawHub 安装教程,OpenClaw Skills 必装工具!

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

1、适用人群（新手友好）

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

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

2、快速入门（非技术人员）

  1. 安装 CLI（参见下一节）。
  2. 搜索你需要的内容：clawhub search "calendar"
  3. 安装一个 Skills：clawhub install <skill-slug>
  4. 启动一个新的 OpenClaw 会话，以加载新 Skills。

3、安装 CLI

npm i -g clawhub# 或pnpm add -g clawhub

3.1 CLI 在 OpenClaw 中的定位

默认情况下，CLI 会将 Skills 安装到当前工作目录下的 ./skills。

如果已配置 OpenClaw 工作区，clawhub 会回退到该工作区，除非你通过 --workdir（或CLAWHUB_WORKDIR）进行覆盖。

OpenClaw 从 <workspace>/skills 加载工作区 Skills，并会在下一个会话中生效。

如果你已经在使用 ~/.openclaw/skills 或内置 Skills，工作区 Skills 优先级更高。有关 Skills 加载、共享和权限控制的更多详情，请参阅 Skills。

3.2 CLI 命令和参数

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

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

3.2.2 认证：

  • clawhub login（浏览器流程）或 clawhub login --token <token>
  • clawhub logout
  • clawhub whoami

选项：

  • --token <token>：粘贴 API 令牌。
  • --label <label>：为浏览器登录令牌存储的标签（默认：CLI token）。
  • --no-browser：不打开浏览器（需要--token）。

3.2.3 搜索

  • clawhub search "query"
  • --limit <n>：最大结果数。

3.2.4 安装

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

3.2.5 更新

  • clawhub update <slug>
  • clawhub update --all
  • --version <version>：更新到指定版本（仅限单个 slug）。
  • --force：当本地文件与任何已发布版本不匹配时强制覆盖。

3.2.6 列表

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

3.2.7 发布：

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

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

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

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

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

4、常用命令

# 登录 https://clawhub.ai/settings  (或基于浏览器登录 clawhub login， 但会遇到速率限制问题)clawhub login --token 你的token(详见文末《常见问题》章节有图文配置教程)# 列表（读取 .clawhub/lock.json）：clawhub list# 搜索：# --limit <n>：最大结果数。clawhub search "query"# 安装：# --version <version>：安装指定版本。# --force：如果文件夹已存在则覆盖。clawhub install <slug># 更新：# --version <version>：更新到指定版本（仅限单个 slug）。# --force：当本地文件与任何已发布版本不匹配时强制覆盖。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

5、高级详情（技术性）

5.1 版本管理和标签

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

5.2 本地更改与注册中心版本

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

5.3 同步扫描和回退根目录

clawhub sync首先扫描当前工作目录。如果未找到 Skills，它会回退到已知的旧版位置（例如~/openclaw/skills和~/.openclaw/skills）。这样设计是为了在不需要额外标志的情况下找到旧版 Skills 安装。

5.4 存储和锁文件

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

5.5 遥测（安装计数）

当你在登录状态下运行clawhub sync时，CLI 会发送一个最小快照用于计算安装次数。你可以完全禁用此功能：

export CLAWHUB_DISABLE_TELEMETRY=1

6、环境变量

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

7、常见问题

7.1 Rate limit exceeded

我查看了 clawhub 的 help 文档后，解决了这个问题。 

需要使用 clawhub login --token ... 进行登录。

具体操作步骤如下： 

  1. 打开 https://clawhub.ai/settings，获取 CLI Token。
  2. 使用 clawhub login --token ... 进行登录。 

然后功能就恢复正常了。

  • https://clawhub.ai/settings

下篇文章推荐阅读👇