跳转至

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 workshop list
openclaw skills workshop changes --limit 20
openclaw skills workshop show <name>
openclaw skills workshop archive <name> --reason "Superseded"
openclaw skills workshop restore <name>

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 复制本地技能目录。当根目录 SKILL.md 在相同内容规则下不可加载时,两者都会在复制前失败:需要带有 description 的 frontmatter, 并且不超过 skills.limits.maxSkillFileBytes。硬链接源文件 会作为新文件复制,因此该链接不会导致检查失败。默认情况下,install、 update 和 verify 指向活动工作区的 skills/ 目录;使用 --global 时,它们指向共享托管技能目录。list/info/check 以及不带子命令的 openclaw skills 会请求所选网关的权威技能 清单。已配置的远程网关或显式 OPENCLAW_GATEWAY_URL 从不回退到客户端本地技能:缺失的 URL、连接失败和 认证错误仍会可见。只有隐式选择的本地网关 在不可用时才能回退到本地清单。基于工作区的 命令按以下顺序解析目标工作区:--agent <id>;如果当前工作目录位于已配置的代理工作区内,则使用当前工作目录;否则使用默认代理。

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

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

info 优先解析精确技能名称,而不是元数据键。键匹配、不区分大小写匹配 以及分隔符规范化匹配必须唯一标识一个技能;模糊选择器 会失败,而不是按发现顺序选择。

check 区分清单、就绪状态和可见性:

  • 清单表示 OpenClaw 已在配置根目录或内置源中找到该技能,并可以报告其状态。
  • 就绪状态表示该技能声明的前置条件已满足所选网关或节点,因此有资格运行。
  • 可见性表示有资格的技能在应用代理过滤器和调用标志后,会暴露给所选代理的提示、选择器或命令界面。

check 独立于代理排除报告缺失的前置条件:被代理允许列表排除的技能也可能出现在缺失要求下。 已禁用的技能以及被内置允许列表阻止的技能保留各自独立的就绪类别。将列出的缺失要求技能视为存在于清单中,但当前对代理没有资格或不可见;在期望模型成功使用它之前,先安装或配置所报告的前置条件。

工作坊命令保持相同的目标边界。在显式选择的网关失败后,它们从不读取或修改客户端本地状态;有意离线行为仅对隐式选择的本地网关可用。

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

由入门引导或 Skills 设置触发的、基于 Gateway 的技能依赖安装,将改用独立的 skills.install 请求路径。

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

说明:

标志/行为 描述
search [query...] 可选查询;省略它以浏览 ClawHub Trending 技能信息流。
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> 指向一个已配置的 agent 工作区;覆盖当前工作目录推断。
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>。如果同时提供,叶子值优先。
list 未提供子命令时的默认操作。
list/info/check 输出 渲染输出发送到 stdout。使用 --json 时,机器可读负载保留在 stdout 上,以便管道和脚本使用。

在支持完整扫描器报告的服务器上,当 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 上的 Control UI 使用持久所有者配置文件,但临时 CLI 连接不会继承它。仅凭 CLI 共享令牌或密码仍然没有个人配置文件;在这种情况下,请使用现有工作区命令。显式选择的远程 Gateway 绝不会回退到客户端本地个人库。

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

技能工作坊

openclaw skills workshop 检查并管理所选代理的学习型(Workshop)技能。代理自行创建和更新这些技能;每个更改都会立即生效,并先保存之前的版本。参见技能工作坊。

openclaw skills workshop list
openclaw skills workshop changes --limit 20
openclaw skills workshop show release-notes
openclaw skills workshop show release-notes --file references/checklist.md
openclaw skills workshop show release-notes --version <version-id>
openclaw skills workshop archive release-notes --reason "Superseded by deploy-notes"
openclaw skills workshop restore release-notes
openclaw skills workshop restore release-notes --version <version-id>
命令 说明
list 列出带有使用次数的实时学习型技能,以及已归档技能。显示自主模式和技能根目录。
changes [--limit <n>] 按最新优先显示最近更改:由谁创建(agent、review、curator、user)、操作以及已保存的版本 ID。
show <name> [--file <path>] [--version <id>] 打印 SKILL.md 或一个支持文件,来自实时技能或已保存版本。
archive <name> [--reason <text>] 从该代理隐藏技能。该技能仍可恢复。
restore <name> [--version <id>] 恢复最新的已保存版本,或指定版本。当前实时副本会先保存,因此恢复可撤销。
命令 描述

每个 Workshop 命令都接受 --agent <id> 和 --json。archive 和 restore 在变更源中以 user 身份操作。

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