ClawHub CLI 使用指南

要解决什么问题

在 OpenClaw 或本地工作区里管理技能包时，若只靠手工拷贝目录，很难对齐远程注册表上的版本，也不清楚本地文件与已安装包是否一致。ClawHub CLI 把「从注册表发现包 → 安装到固定目录 → 按内容哈希判断是否需要升级 → 发布自己的包」串成同一套命令面，减少脚本拼凑。

核心能力与用法

技能文档按命令块组织，覆盖典型工作流：

• 安装：把指定技能落到工作目录下的 ./skills（或你通过 --workdir / --dir / 环境变量 CLAWHUB_WORKDIR 指定的路径）。
• 搜索：在默认注册表 https://clawhub.com 上查找包；可用 CLAWHUB_REGISTRY 或 --registry 指向私有或镜像源。
• 更新：update 会对本地文件算哈希，解析与注册表匹配的版本；未指定 --version 时升级到该包的最新版，避免「目录还在但内容已漂移」却误以为已更新。
• 列表：查看当前工作区内已安装条目，便于核对。
• 发布与认证：发布前需完成 Auth (publish) 相关认证流程，再执行 Publish 将包推到注册表。

默认工作目录为当前 cwd，若无合适上下文会回退到 OpenClaw workspace，与「在 agent 工程根目录操作」的习惯一致。

边界与注意点

• 注册表、安装目录均可覆盖，团队内应统一 CLAWHUB_REGISTRY 与 CLAWHUB_WORKDIR，否则同一条 install 在不同机器上可能落到不同路径。
• 更新依赖哈希匹配与版本解析逻辑；若你本地改过包内容但未走发布流程，升级行为以 CLI 的匹配规则为准，不要假设「只改文件夹名」就能锁定版本。
• 文档侧重命令语义与默认行为，不包含业务侧如何编写 SKILL.md 本身；发布前仍需自行保证包结构与元数据符合目标注册表要求。