ClawdHub

ClawdHub 是 Moltbot 的公共技能注册表，为免费服务：技能公开、开放，供所有人浏览与复用。每个技能即一个包含 SKILL.md 的目录（及辅助文本文件）。可在网页中浏览技能，或使用 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 加载工作区技能，在下一会话中生效。若你已使用 ~/.clawdbot/skills 或内置技能，工作区技能优先级更高。技能如何加载、共享与门控的细节见 Skills。

服务提供的能力

• 公开浏览技能及其 SKILL.md 内容。
• 搜索基于向量（embedding），不限于关键词。
• 版本：semver、changelog、标签（含 latest）。
• 下载：按版本提供 zip。
• 星标与评论供社区反馈。
• 审核钩子用于审批与审计。
• CLI 友好 API 便于自动化与脚本。

CLI 命令与参数

全局选项：--workdir <dir>、--dir <dir>、--site <url>、--registry <url>、--no-input、-V, --cli-version。认证：clawdhub login（浏览器流程）或 clawdhub login --token <token>、clawdhub logout、clawdhub whoami。搜索：clawdhub search "query"、--limit <n>。安装：clawdhub install <slug>、--version <version>、--force。更新：clawdhub update <slug>、clawdhub update --all、--version、--force。列表：clawdhub list（读取 .clawdhub/lock.json）。发布：clawdhub publish <path>、--slug、--name、--version、--changelog、--tags。删除/恢复（仅所有者/管理员）：clawdhub delete <slug> --yes、clawdhub undelete <slug> --yes。同步（扫描本地技能 + 发布新/更新）：clawdhub sync、--root、--all、--dry-run、--bump、--changelog、--tags、--concurrency。

常见代理工作流

搜索技能：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）指向某版本；移动标签可回滚。本地变更与注册表版本：更新时按内容哈希比较本地技能与注册表版本；若本地与任何已发布版本不匹配，CLI 会询问是否覆盖（非交互运行需 --force）。同步扫描与回退根目录：clawdhub sync 先扫描当前 workdir；若未发现技能则回退到已知旧路径（如 ~/moltbot/skills、~/.clawdbot/skills），便于在不加额外参数的情况下找到旧安装。存储与锁文件：已安装技能记录在 workdir 下的 .clawdhub/lock.json；认证 token 存在 ClawdHub CLI 配置文件中（可通过 CLAWDHUB_CONFIG_PATH 覆盖）。遥测（安装计数）：登录后运行 clawdhub sync 时，CLI 会发送最小快照以统计安装数。可完全关闭：export CLAWDHUB_DISABLE_TELEMETRY=1。

环境变量

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