`openclaw skills`¶

检查本地技能、搜索 ClawHub、从 ClawHub/Git/本地目录安装技能、验证 ClawHub 技能，以及更新 ClawHub 追踪的安装。

插件包请使用 openclaw plugins。独立的 ClawHub CLI 负责处理发布、注册表维护以及移除 ClawHub 技能。

命令¶

openclaw skills search "calendar"
openclaw skills search --limit 20 --json
openclaw skills install @owner/<slug>
openclaw skills install @owner/<slug> --version <version>
openclaw skills install skills-sh:<owner>/<repo>/<slug>
openclaw skills install git:owner/repo
openclaw skills install git:owner/repo@main
openclaw skills install ./path/to/skill --as custom-name
openclaw skills install @owner/<slug> --force
openclaw skills install @owner/<slug> --force-install
openclaw skills install @owner/<slug> --acknowledge-install-policy-warning
openclaw skills install @owner/<slug> --agent <id>
openclaw skills install @owner/<slug> --global
openclaw skills update @owner/<slug>
openclaw skills update @owner/<slug> --force
openclaw skills update @owner/<slug> --force-install
openclaw skills update @owner/<slug> --acknowledge-install-policy-warning
openclaw skills update @owner/<slug> --global
openclaw skills update --all
openclaw skills update --all --agent <id>
openclaw skills update --all --global
openclaw skills verify @owner/<slug>
openclaw skills verify @owner/<slug> --json
openclaw skills verify @owner/<slug> --version <version>
openclaw skills verify @owner/<slug> --tag <tag>
openclaw skills verify @owner/<slug> --card
openclaw skills verify @owner/<slug> --global
openclaw skills list
openclaw skills list --eligible
openclaw skills list --json
openclaw skills list --verbose
openclaw skills list --agent <id>
openclaw skills info <name>
openclaw skills info <name> --json
openclaw skills info <name> --agent <id>
openclaw skills check
openclaw skills check --agent <id>
openclaw skills check --json
openclaw skills curator status
openclaw skills curator status --json
openclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.md
openclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.md
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md
openclaw 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 skills-sh:<owner>/<repo>/<slug> 请求 ClawHub 将外部列表解析为精确同步的 GitHub 提交；OpenClaw 不会从 skills.sh 下载。这些条目显示为 未经 ClawHub 扫描，并且该信任状态在更新和验证过程中保持不变。已认领或经 ClawHub 扫描的技能使用 @owner/<slug>。install git:owner/repo[@ref] 克隆不受管理的 Git 技能，install ./path 复制本地技能目录。默认情况下，install、update 和 verify 以当前工作区的 skills/ 目录为目标；使用 --global 时，它们以共享的受管技能目录为目标。list/info/check 以及不带子命令的 openclaw skills 请求所选 Gateway 的权威技能清单。已配置的远程 Gateway 或显式设置的 OPENCLAW_GATEWAY_URL 永远不会回退到客户端本地技能：缺失的 URL、连接失败和身份验证错误仍然会显示。只有隐式选择的本地 Gateway 才能在其不可用时回退到本地清单。受工作区支持的命令按以下顺序解析目标工作区：优先使用 --agent <id>，其次，当当前工作目录位于已配置的 agent 工作区内时使用该目录，最后使用默认 agent。

搜索结果仅对数字版本标签添加 v，保留现有的前缀和构建名称。JSON 输出保留注册表中的原始版本值。

技能表格将水平制表符渲染为单个空格，以便描述与相邻列保持对齐。JSON 输出将描述和路径中的制表符与换行符保留为转义字符。

info 先解析精确的技能名称，再解析元数据键。键匹配、不区分大小写匹配和分隔符规范化匹配必须唯一标识一个技能；存在歧义的选择器将失败，而不会按发现顺序进行选择。Workshop 读取和更新目标使用相同的查找逻辑。

check 独立于 agent 排除规则报告缺失的依赖项：被 agent 允许列表排除的技能也可能出现在缺失依赖项下。已禁用的技能和被捆绑允许列表阻止的技能保持各自独立的就绪状态类别。

Curator 的 status、pin、unpin、restore 以及 Workshop 的 apply 保持相同的目标边界。在显式选择的 Gateway 失败后，它们绝不会读取或修改客户端本地状态；有意的离线行为仅对隐式选择的本地 Gateway 可用。

Git 和本地目录安装要求在源根目录存在 SKILL.md。安装 slug 在 SKILL.md frontmatter 的 name 有效时取自该值，否则取自源目录或仓库名称；可使用 --as <slug> 覆盖。--version 仅适用于 ClawHub。技能安装不支持 npm 包规范或 zip/归档路径，且 openclaw skills update 仅更新 ClawHub 追踪的安装。

从引导流程或技能设置触发的、由 Gateway 支持的技能依赖安装改用独立的 skills.install 请求路径。

当 security.installPolicy 在交互式终端中返回 warn 时，OpenClaw 会打印原因和发现，然后要求输入 type: '<skill>' to install anyway（或 update anyway）。如果完整渲染的审查内容超过 4,000 个字符，OpenClaw 会在提示之前按失败关闭（fail closed）处理；请先缩减或合并策略输出。当用户给出匹配的答案时，会在继续之前重新评估暂存的技能。被拒绝的命令以及非交互式的直接 CLI 命令会在提交前停止；审查之后，--acknowledge-install-policy-warning 是对该命令调用中每个警告的显式非交互式批准。每个已批准的警告在继续之前都会被重新评估。自动和受管技能安装本身不能使用该标志。如果存在等效的直接 CLI 命令，请使用该命令；否则，将 security.installPolicy 改为对已审查的请求返回 allow，然后重试受管流程。--force 和该确认都不能覆盖 block 或策略失败。

备注：

标志/行为	描述
`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 技能引用，不适用于 `skills-sh:` 引用；镜像引用已经标识了精确的同步提交。
`install --force`	覆盖同一 slug 的现有工作区技能文件夹。
`update --force`	即使已安装文件不再与记录的安装摘要匹配，也会替换受跟踪的技能。若未指定，更新会保留本地更改。摘要之前的安装需要一次强制更新，之后才能验证后续更新。请单独强制更新这些技能；`--all --force` 也会替换检测到本地编辑的技能。
`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` 作为显式的机器输出写法。当技能已安装或无歧义时，为兼容性接受裸 slug；带所有者的引用可避免发布者歧义。
`verify` 出处	当 ClawHub 返回服务器解析的源出处时，verify JSON 还会包含一个固定到提交的 `openclaw.verifiedSourceUrl`。不可用或自声明的源 URL 仅保留在原始出处信封中，不会被提升。

标志/行为	描述
`verify` 版本选择器	`verify` 对已安装的 ClawHub 技能使用 `.clawhub/origin.json`，因此它会针对其来源注册表验证已安装版本。`--version` 和 `--tag` 会覆盖版本选择器，但在存在来源元数据时仍保留该已安装注册表。
`verify --card`	打印生成的 Skill Card Markdown，而不是 JSON。当 ClawHub 返回 `ok: false` 或 `decision: "fail"` 时以非零状态退出。
Skill Card 指纹	已安装的 ClawHub 捆绑包可以包含生成的 `skill-card.md`。OpenClaw 将验证视为 ClawHub 服务器决策，并且不会仅因为该生成的卡片改变了捆绑包指纹而拒绝已安装的技能。
`check --agent <id>`	检查所选代理的工作区，并报告哪些就绪技能实际可见于该代理的提示或命令界面。
`workshop --agent <id>`	可接受在 Workshop 叶子命令之前或之后，例如 `workshop --agent <id> list` 或 `workshop list --agent <id>`。如果同时提供，叶子命令的值优先。
`curator --json`	可接受在 Curator 叶子命令之前或之后，例如 `curator --json status` 或 `curator status --json`。
`list`	未提供子命令时的默认操作。
`list`/`info`/`check` 输出	渲染输出会写入 stdout。使用 `--json` 时，机器可读负载仍保留在 stdout 上，供管道和脚本使用。
`curator status --json`	报告从可信 `skill.used` 事件记录的实时 Workshop 技能使用情况、每个代理的集合审查结果，以及每个代理和工作区的经验审查结果。
`curator pin`/`unpin`/`restore`	已弃用的命令仍保持注册，但会返回错误，说明每周集合审查管理技能集合。

Workshop 清单与升级¶

openclaw skills curator status 会从所选 Gateway 请求当前 Workshop 清单。对于兼容的 Gateway，JSON 包含 "inventory": "live-workshop"。本地状态也会使用当前配置。缺失的使用情况显示为 not recorded，这并不证明某技能从未被使用。

较旧的 Gateway 可能返回未标记的旧版响应。CLI 会接受它，而不会切换到本地状态，并在文本输出中打印有限覆盖范围的通知。JSON 会保留该标记缺失的状态。有关成员资格、跟踪限制、未知日期和升级行为，请参阅 Workshop 清单与使用情况。

在支持完整扫描器报告的服务器上，当 ClawHub 已保留这些报告时，验证 JSON 会包含 security.scannerReports.aig（完整的上游 SARIF 报告）和 security.scannerReports.skillspector（完整的上游 JSON 报告）。嵌套的扫描器字段原样传递，包括覆盖范围和不完整分析详情。当报告不可用时，报告为 null，包括未保留完整输出的较早扫描；不会用摘要替代。较旧的服务器可能完全省略 security.scannerReports。verify 读取已存储的扫描，而不会启动另一次扫描。验证响应最大可达 64 MiB；更大的响应会明确失败，而不会打印部分报告。其他 ClawHub JSON 请求仍保留其 16 MiB 限制。

发布信任¶

社区 ClawHub 技能安装和更新会在下载前检查信任。带版本的社区归档发布使用精确发布信任元数据。由解析器支持的 GitHub 技能依赖 ClawHub 的安装解析器，在返回固定提交之前强制执行扫描和强制安装策略；使用 --force-install 可在该扫描完成前安装待处理的 GitHub 支持技能。恶意或被阻止的社区发布会被拒绝。审查结果会打印确切的 ClawHub 审计概览和详情链接，然后继续。官方 ClawHub 技能发布者和捆绑的 OpenClaw 技能源会绕过此发布信任检查。

移除 ClawHub 技能¶

使用独立 ClawHub CLI 移除 ClawHub 跟踪的技能。如果 CLI 未安装，请先显式安装：

npm i -g clawhub
clawhub uninstall @owner/my-skill

CLI 在删除技能目录及其 .clawhub/lock.json 条目之前会请求确认。使用已安装技能的所有者限定名称或纯 slug，而不是其原始 skills-sh: 引用。

选择技能安装所在的同一根目录：对于代理特定技能，选择代理工作区；对于使用 --global 安装的共享技能，选择 OpenClaw 状态目录：

clawhub --workdir /path/to/agent-workspace uninstall @owner/my-skill
clawhub --workdir ~/.openclaw uninstall @owner/my-skill

如果设置了 OPENCLAW_STATE_DIR，请改为使用该配置的状态目录来管理共享技能：

clawhub --workdir "$OPENCLAW_STATE_DIR" uninstall @owner/my-skill

默认的技能监视器会在下一个代理轮次中检测到移除。如果已禁用监视，请启动新会话。

个人技能库¶

openclaw skills library 管理所选 Gateway 上已识别调用者的技能。它使用与控制 UI 和代理工作流相同的感知所有者的服务；它绝不会在 CLI 主机上写入库数据库或修订版本目录。

openclaw skills library --help

列出你的库：

openclaw skills library list --scope mine --json

从包含 SKILL.md 的目录创建私有技能：

openclaw skills library create ./my-skill --slug my-skill

编辑前读取其稳定 ID 和当前修订版本：

openclaw skills library read <skill-id> --json

仅更新说明，同时保留支持文件：

openclaw skills library update <skill-id> ./SKILL.md --expected-revision <revision-hash>

目录输入会替换完整捆绑包。单个 SKILL.md 输入会保留当前支持文件；重复使用 --delete-file <relative-path> 可显式删除文件。更新会比较已读取的修订版本；发生冲突时需要查看较新的内容，而不是强制覆盖。支持文件是修订版本的一部分，包括二进制资产和执行标志。

私有导入 ZIP：

openclaw skills library import ./my-skill.zip --slug my-skill

导入 ClawHub 技能而不发布你的库：

openclaw skills library import @owner/<slug> --clawhub --slug my-skill

--version <version> 选择 ClawHub 版本，并要求 --clawhub。 share、unshare、transfer、enable、disable、remove 和 rollback 接受 <skill-id> --expected-revision <hash>。回滚还要求 --revision <retained-hash>。

将精确修订版本附加到现有会话：

openclaw skills library attach --session <session-key> --skill-id <skill-id> --revision <revision-hash>

detach 接受相同的会话和技能 ID。刷新一个已选技能：

openclaw skills library refresh --session <session-key> --skill-id <skill-id>

省略 --skill-id 会刷新所有已选技能，并要求对每个技能具有当前库访问权限。它绝不会用当前调用者的库替换选择。每个操作都会在下一轮报告其效果。

使用 list --session <session-key> 检查已选修订版本和可附加的技能，而不更改会话。read --session <session-key> 还要求 --revision <hash>，并且只读取该精确已选修订版本；它不会暴露其他私有修订版本，也不会授予编辑它们的权限。

个人操作需要已认证的 Gateway 配置文件。单用户 Gateway 上的控制 UI 使用持久所有者配置文件，但临时 CLI 连接不会继承它。仅 CLI 共享令牌或密码仍然没有个人配置文件；在这种情况下，请使用现有工作区命令。显式选择的远程 Gateway 绝不会回退到客户端本地个人库。

共享会使技能可供团队成员使用，但不会授予编辑权限。转移到团队所有权需要管理员权限。保存默认影响新会话；对于现有会话，请显式附加或刷新选择。移除会保留已选修订版本。参见个人库所有权和修订版本。

技能工作坊¶

openclaw skills workshop 管理所选代理的待处理技能提案。提案在应用之前不是活动技能。有关提案存储、支持文件保护、Gateway 方法和审批策略，请参阅技能工作坊。

openclaw skills workshop propose-create \
  --name "qa-check" \
  --description "Repeatable QA checklist" \
  --proposal ./PROPOSAL.md
openclaw skills workshop propose-create \
  --name "qa-check" \
  --description "Repeatable QA checklist" \
  --proposal-dir ./qa-check-proposal
openclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.md
openclaw skills workshop list
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.md
openclaw skills workshop apply <proposal-id>
openclaw skills workshop reject <proposal-id> --reason "Duplicate"
openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"

propose-create、propose-update 和 revise 还接受 --goal <text> 和 --evidence <text>，用于在 --proposal/--proposal-dir 内容旁边记录提案动机和支持说明。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw

openclaw skills¶

命令¶