search [query...] | 可选查询；省略它即可浏览默认的 ClawHub 搜索信息流。 |
search --limit <n> | 限制返回的结果数量。 |
install git:owner/repo[@ref] | 安装 Git 技能。分支 ref 可以包含斜杠，例如 git:owner/repo@feature/foo。 |
install ./path/to/skill | 安装根目录包含 SKILL.md 的本地目录。 |
install --as <slug> | 覆盖 Git 和本地目录安装推断出的 slug。 |
install --version <version> | 仅适用于 ClawHub 技能 ref。 |
install --force | 覆盖同一 slug 的现有工作区技能文件夹。 |
install/update --force-install | 在 ClawHub 扫描完成前安装待处理的、由 GitHub 支撑的 ClawHub 技能。 |
--global | 以共享的托管技能目录为目标；不能与 --agent <id> 组合使用。 |
--agent <id> | 以一个已配置的智能体工作区为目标；覆盖当前工作目录推断。 |
update @owner/<slug> | 更新单个已跟踪的技能。添加 --global 可将目标从工作区改为共享的托管技能目录。 |
update --all | 更新所选工作区中的已跟踪 ClawHub 安装，或在使用 --global 时更新共享的托管技能目录。 |
verify @owner/<slug> | 默认打印 ClawHub 的 clawhub.skill.verify.v1 JSON 信封。没有 --json 标志，因为 JSON 已经是默认输出。为兼容性接受裸 slug，但仅限技能已经安装或没有歧义的情况；带 owner 的 ref 可避免发布者歧义。 |
verify 来源证明 | 当 ClawHub 返回服务器解析的来源证明时，verify JSON 还会包含固定到提交的 openclaw.verifiedSourceUrl。不可用或自声明的源 URL 只会留在原始来源证明信封中，不会被提升。 |
verify 版本选择器 | 对已安装的 ClawHub 技能，verify 使用 .clawhub/origin.json，因此会依据其来源注册表验证已安装版本。--version 和 --tag 会覆盖版本选择器，但在存在 origin 元数据时仍保留该已安装注册表。 |
verify --card | 打印生成的技能卡 Markdown，而不是 JSON。当 ClawHub 返回 ok: false 或 decision: "fail" 时以非零退出；除非 ClawHub 策略变更，未签名签名仅作为信息。 |
| 技能卡指纹 | 已安装的 ClawHub bundle 可以包含生成的 skill-card.md。OpenClaw 将验证视为 ClawHub 服务器决策，不会仅因为该生成卡片改变 bundle 指纹就拒绝已安装技能。 |
check --agent <id> | 检查所选智能体的工作区，并报告哪些已就绪技能实际对该智能体的 prompt 或命令界面可见。 |
list | 未提供子命令时的默认操作。 |
list/info/check 输出 | 渲染后的输出会写入 stdout。使用 --json 时，机器可读 payload 会保留在 stdout，便于管道和脚本使用。 |
