clawhub

• 在运行时获取新技能 — 您的智能体需要一项最初未打包的能力，应按需从注册表中拉取。
• 锁定已安装技能的版本 — 您希望将某个技能锁定到已知的稳定版本（例如 1.2.3），以避免意外的破坏性变更。
• 保持工作区处于最新状态 — 您希望通过单个 update --all 命令将所有已安装的技能批量升级到最新版本。
• 发布您自己的技能 — 您已构建了一个新的技能文件夹，并希望通过版本化发布和变更日志将其分享到 clawhub.com。

• 如果您只需要在初始设置时进行一次性技能安装 — 直接复制文件或使用标准的 npm install 步骤，可能比调用完整的 ClawHub CLI 更简单。
• 如果您的环境无法访问互联网 — ClawHub 依赖 clawhub.com 注册表（或自定义的 CLAWHUB_REGISTRY），在没有自托管注册表的完全隔离环境中将无法正常运行。

通过自然语言或关键词搜索（例如 clawhub search "postgres backups"）查询 clawhub.com 注册表，无需离开终端或代理会话即可发现可用技能。

通过 clawhub install my-skill 按 slug 安装任意技能，或使用 --version 1.2.3 固定到特定版本。技能默认安装至 ./skills 目录，可通过 --dir 参数或 CLAWHUB_WORKDIR 环境变量进行配置。

update 命令对本地技能文件进行哈希处理，解析匹配的上游版本，并升级到最新发布版本（或指定的固定版本）。使用 --all 参数可一次性升级所有已安装的技能，结合 --force 和 --no-input 标志可适用于自动化流水线场景。

使用单个命令将本地 skill 文件夹发布到注册表，需提供 slug、显示名称、版本号和更新日志字符串。需要已登录的 clawhub login 会话。

通过 CLAWHUB_REGISTRY 环境变量或 --registry 标志，可覆盖默认的 https://clawhub.com 注册表。工作目录默认为当前目录（回退至 OpenClaw 工作区），可通过 --workdir 或 CLAWHUB_WORKDIR 进行覆盖。

一个智能体在任务执行过程中发现需要某个尚未安装的技能。它调用 clawhub install <slug> 从注册表中拉取最新版本，并立即获得该能力——无需人工干预。

一个部署流水线运行 clawhub update --all --no-input --force，以确保在智能体环境启动之前，工作区中的每个技能都处于最新版本，从而消除跨部署的版本漂移。

开发者完成技能更新后，运行 clawhub publish ./my-skill --slug my-skill --version 1.3.0 --changelog "Bug fixes + new actions"，该技能即可立即在 clawhub.com 上供其他用户和智能体安装使用。

一个团队使用 clawhub install my-skill --version 1.2.3 将关键技能固定到经过测试的版本，确保生产环境中的智能体永远不会自动升级到未经测试的版本，除非在其配置中明确进行版本变更。