文档
工具（Tools）
ClawdHub

ClawdHub

适用范围

在以下情况使用此页面:

  • 向新用户介绍 ClawdHub
  • 安装、搜索或发布技能
  • 解释 ClawdHub CLI 标志和同步行为

ClawdHub 是 Moltbot 的公共技能注册表。这是一项免费服务:所有技能都是公开、开放的，对所有人可见，以便共享和重用。技能只是一个包含 SKILL.md 文件(以及支持文本文件)的文件夹。你可以在 Web 应用中浏览技能，或使用 CLI 来搜索、安装、更新和发布技能。

网站: clawdhub.com

适用对象(适合初学者)

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

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

快速开始(非技术人员)

  1. 安装 CLI(参见下一节)。
  2. 搜索你需要的内容:
    • clawdhub search "calendar"
  3. 安装技能:
    • clawdhub install <skill-slug>
  4. 启动新的 Moltbot 会话，以便它获取新技能。

安装 CLI

选择一个:

npm i -g clawdhub
pnpm add -g clawdhub

如何集成到 Moltbot

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

有关如何加载、共享和限制技能的更多详细信息，请参阅技能。

服务提供的功能

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

CLI 命令和参数

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

  • --workdir <dir>: 工作目录(默认:当前目录;回退到 Moltbot 工作空间)。
  • --dir <dir>: 技能目录，相对于工作目录(默认: 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>: Changelog 文本(可以为空)。
  • --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>: 非交互式更新的 changelog。
  • --tags <tags>: 逗号分隔的标签(默认: latest)。
  • --concurrency <n>: 注册表检查(默认: 4)。

代理的常用工作流

搜索技能 

clawdhub search "postgres backups"

下载新技能 

clawdhub install my-skill-pack

更新已安装的技能 

clawdhub update --all

备份你的技能(发布或同步)

对于单个技能文件夹:

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

要一次扫描和备份多个技能:

clawdhub sync --all

高级详细信息(技术)

版本控制和标签

  • 每次发布都会创建一个新的 semver SkillVersion。
  • 标签(如 latest)指向一个版本;移动标签允许你回滚。
  • Changelogs 按版本附加，在同步或发布更新时可以为空。

本地更改 vs 注册表版本

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

同步扫描和回退根目录

clawdhub sync 首先扫描你的当前工作目录。如果未找到技能，它会回退到已知的旧位置(例如 ~/moltbot/skills 和 ~/.moltbot/skills)。这是为了在不需要额外标志的情况下找到较旧的技能安装。

存储和锁文件

  • 已安装的技能记录在工作目录下的 .clawdhub/lock.json 中。
  • 认证令牌存储在 ClawdHub CLI 配置文件中(通过 CLAWDHUB_CONFIG_PATH 覆盖)。

遥测(安装计数)

当你在登录时运行 clawdhub sync 时，CLI 会发送一个最小的快照来计算安装计数。你可以完全禁用它:

export CLAWDHUB_DISABLE_TELEMETRY=1

环境变量

  • CLAWDHUB_SITE: 覆盖站点 URL。
  • CLAWDHUB_REGISTRY: 覆盖注册表 API URL。
  • CLAWDHUB_CONFIG_PATH: 覆盖 CLI 存储令牌/配置的位置。
  • CLAWDHUB_WORKDIR: 覆盖默认工作目录。
  • CLAWDHUB_DISABLE_TELEMETRY=1: 在 sync 上禁用遥测。
Chrome 扩展（浏览器中继）Exec 工具