OpenClaw中文社区

主题

ClawdHub ​

ClawdHub 是 OpenClaw 的公共技能注册表。这是一项免费服务：所有技能都是公开的、开放的，每个人都可以查看以进行共享和重用。技能只是一个带有 SKILL.md 文件的文件夹（加上支持文本文件）。你可以在 Web 应用中浏览技能，或使用 CLI 搜索、安装、更新和发布技能。

站点：clawdhub.com

适用人群（适合初学者） ​

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

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

快速开始（非技术） ​

  1. 安装 CLI（见下一节）。
  2. 搜索你需要的东西：
    • clawdhub search "calendar"
  3. 安装技能：
    • clawdhub install <skill-slug>
  4. 启动新的 OpenClaw 会话以拾取新技能。

安装 CLI ​

选择其一：

bash
npm i -g clawdhub
bash
pnpm add -g clawdhub

它如何融入 OpenClaw ​

默认情况下，CLI 会将技能安装到当前工作目录下的 ./skills。如果配置了 OpenClaw 工作区，clawdhub 会回退到该工作区，除非你覆盖 --workdir（或 CLAWDHUB_WORKDIR）。OpenClaw 从 <workspace>/skills 加载工作区技能，并将在下次会话中拾取它们。如果你已经使用 ~/.openclaw/skills 或捆绑技能，工作区技能优先。

有关技能如何加载、共享和门控的更多详情，请参阅技能。

服务提供的内容（功能） ​

  • 技能及其 SKILL.md 内容的公共浏览。
  • 由嵌入驱动的搜索（向量搜索），而不仅仅是关键词。
  • 带有 semver、变更日志和标签（包括 latest）的版本控制。
  • 每个版本的 zip下载。
  • 用于社区反馈的星标和评论。
  • 用于审批和审计的审核钩子。
  • 用于自动化和脚本的CLI 友好 API。

CLI 命令和参数 ​

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

  • --workdir <dir>：工作目录（默认：当前目录；回退到 OpenClaw 工作区）。
  • --dir <dir>：技能目录，相对于 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 令牌。
  • --label <label>：为浏览器登录令牌存储的标签（默认：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>：技能 slug。
  • --name <name>：显示名称。
  • --version <version>：Semver 版本。
  • --changelog <text>：变更日志文本（可以为空）。
  • --tags <tags>：逗号分隔的标签（默认：latest）。

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

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

同步（扫描本地技能 + 发布新的/更新的）：

  • clawdhub sync
  • --root <dir...>：额外扫描根目录。
  • --all：无需提示即可上传所有内容。
  • --dry-run：显示将要上传的内容。
  • --bump <type>：patch|minor|major 用于更新（默认：patch）。
  • --changelog <text>：用于非交互式更新的变更日志。
  • --tags <tags>：逗号分隔的标签（默认：latest）。
  • --concurrency <n>：注册表检查（默认：4）。

智能体的常见工作流程 ​

搜索技能 ​

bash
clawdhub search "postgres backups"

下载新技能 ​

bash
clawdhub install my-skill-pack

更新已安装的技能 ​

bash
clawdhub update --all

备份你的技能（发布或同步） ​

对于单个技能文件夹：

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

一次扫描并备份多个技能：

bash
clawdhub sync --all

高级详情（技术） ​

版本控制和标签 ​

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

本地更改 vs 注册表版本 ​

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

同步扫描和回退根目录 ​

clawdhub sync 首先扫描你当前的 workdir。如果没有找到技能，它会回退到已知的旧位置（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。这是为了在没有额外标志的情况下找到旧的技能安装。

存储和锁定文件 ​

  • 已安装的技能记录在你 workdir 下的 .clawdhub/lock.json 中。
  • 认证令牌存储在 ClawdHub CLI 配置文件中（通过 CLAWDHUB_CONFIG_PATH 覆盖）。

遥测（安装计数） ​

当你在登录时运行 clawdhub sync，CLI 会发送最小快照以计算安装计数。你可以完全禁用此功能：

bash
export CLAWDHUB_DISABLE_TELEMETRY=1

环境变量 ​

  • CLAWDHUB_SITE：覆盖站点 URL。
  • CLAWDHUB_REGISTRY：覆盖注册表 API URL。
  • CLAWDHUB_CONFIG_PATH：覆盖 CLI 存储令牌/配置的位置。
  • CLAWDHUB_WORKDIR：覆盖默认的 workdir。
  • CLAWDHUB_DISABLE_TELEMETRY=1：在 sync 时禁用遥测。

基于 MIT 许可发布

Copyright © 2026-present OpenClaw中文社区