CLI 命令
Skills
openclaw skills
检查本地技能、搜索 ClawHub、从 ClawHub/Git/本地目录安装技能、验证 ClawHub 技能，以及更新由 ClawHub 跟踪的安装。
相关内容：
命令
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --force-installopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --force-installopenclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"search、update 和 verify 直接使用 ClawHub。install @owner/<slug>
安装 ClawHub 技能，install git:owner/repo[@ref] 克隆 Git 技能，
而 install ./path 复制本地技能目录。默认情况下，install、
update 和 verify 以活动工作区的 skills/ 目录为目标；使用
--global 时，则以共享的托管技能目录为目标。list/info/check
仍会检查当前工作区和配置可见的本地技能。
基于工作区的命令首先从 --agent <id> 解析目标工作区，
然后在当前工作目录位于已配置的智能体工作区内时使用该目录，
最后回退到默认智能体。
Git 和本地目录安装要求源根目录中存在 SKILL.md。安装
slug 首先取自 SKILL.md frontmatter 中有效的 name，然后
取源目录或仓库名称；可使用 --as <slug> 覆盖它。
--version 仅适用于 ClawHub。技能安装不支持 npm 软件包规范
或 zip/归档路径，并且 openclaw skills update 仅更新由 ClawHub 跟踪的
安装。
在新手引导或 Skills
设置中触发的、由 Gateway 网关支持的技能依赖安装改用单独的 skills.install 请求路径。
注意事项：
| 标志/行为 | 说明 |
|---|---|
search [query...] |
可选查询；省略时浏览默认的 ClawHub 搜索信息流。 |
search --limit <n> |
限制返回的结果数量。 |
install git:owner/repo[@ref] |
安装 Git 技能。分支引用可以包含斜杠，例如 git:owner/repo@feature/foo。 |
install ./path/to/skill |
安装根目录中包含 SKILL.md 的本地目录。 |
install --as <slug> |
覆盖为 Git 和本地目录安装推断出的 slug。 |
install --version <version> |
仅适用于 ClawHub 技能引用。 |
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；带所有者限定的引用可避免发布者歧义。 |
verify 来源 |
当 ClawHub 返回由服务器解析的源来源信息时，验证 JSON 还会包含固定到提交的 openclaw.verifiedSourceUrl。不可用或自行声明的源 URL 仅保留在原始来源信封中，不会被提升。 |
verify 版本选择器 |
verify 对已安装的 ClawHub 技能使用 .clawhub/origin.json，因此会对照其来源注册表验证已安装版本。--version 和 --tag 会覆盖版本选择器，但在存在来源元数据时仍使用已安装时的注册表。 |
verify --card |
输出生成的技能卡 Markdown，而不是 JSON。当 ClawHub 返回 ok: false 或 decision: "fail" 时以非零状态退出；除非 ClawHub 策略发生变化，否则未签名的签名仅供参考。 |
| 技能卡指纹 | 已安装的 ClawHub 捆绑包可以包含生成的 skill-card.md。OpenClaw 将验证视为 ClawHub 服务器的决定，不会仅因生成的卡片改变了捆绑包指纹而拒绝已安装的技能。 |
check --agent <id> |
检查所选智能体的工作区，并报告哪些就绪技能实际对该智能体的提示词或命令界面可见。 |
list |
未提供子命令时的默认操作。 |
list/info/check 输出 |
渲染后的输出写入 stdout。使用 --json 时，机器可读载荷仍保留在 stdout，以供管道和脚本使用。 |
社区 ClawHub 技能安装和更新会在下载前检查信任状态。
社区归档的版本化发行版使用精确发行版信任元数据。
由解析器支持的 GitHub 技能依赖 ClawHub 的安装解析器，在返回固定提交前执行
扫描和强制安装策略；可使用
--force-install 在扫描完成前安装待处理的 GitHub 支持的技能。
恶意或被阻止的社区发行版会被拒绝。高风险的
社区发行版需要审查；当非交互式命令应在审查后继续执行时，还需要使用 --acknowledge-clawhub-risk。
ClawHub 官方
技能发布者和 OpenClaw 内置技能源会跳过此发行版信任
提示。
技能工作坊
openclaw skills workshop 用于管理所选工作区中待处理的技能提案。提案在应用之前并不是已启用的技能。有关提案存储、支持文件保护措施、Gateway 网关方法和审批策略，请参阅
技能工作坊。
openclaw skills workshop propose-create \ --name "qa-check" \ --description "可重复执行的 QA 检查清单" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "可重复执行的 QA 检查清单" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "重复"openclaw skills workshop quarantine <proposal-id> --reason "需要安全审查"propose-create、propose-update 和 revise 还接受 --goal <text>
和 --evidence <text>，以便在记录 --proposal/--proposal-dir 内容的同时，记录提案的动机和支持性说明。
