概述

openclaw skills 检查本地 skill 并从 ClawHub 安装/更新 skill。无子命令时等同于 skills list。

openclaw skills search [query] [--limit N] [--json]
openclaw skills install <slug> [--version <v>] [--force] [--agent <id>]
openclaw skills update <slug>
openclaw skills update --all [--agent <id>]
openclaw skills list [--eligible] [--verbose] [--json] [--agent <id>]
openclaw skills info <name> [--json] [--agent <id>]
openclaw skills check [--agent <id>] [--json]

子命令说明

命令说明
search远程查询 ClawHub skill 目录(不影响本地状态);省略 query 浏览默认推荐
install <slug>从 ClawHub 下载 skill 到工作区 skills/ 目录
update <slug>更新已追踪的 ClawHub skill
update --all更新当前工作区所有已追踪的 ClawHub skill
list列出当前工作区可见的所有 skill
info <name>显示指定 skill 的详细信息
check检查 skill 就绪状态(二进制/环境变量/配置依赖)

工作区解析优先级

--agent <id> > 当前目录(在某个 agent 工作区内)> 默认 agent

search/install/update 操作 ClawHub,安装到活跃工作区的 skills/ 目录。list/info/check 检查本地 skill。


注意事项

  • install --force 覆盖同 slug 的已有工作区 skill 目录
  • update --all 只更新当前工作区中已追踪的 ClawHub 安装
  • check --agent <id> 检查指定 agent 工作区,报告哪些就绪 skill 实际对该 agent 的 prompt 或命令界面可见
  • Gateway 触发的 skill 依赖安装(如 onboarding 或 Skills 设置)走独立的 skills.install 请求路径,不是此 CLI 命令

相关页面

  • concepts/tool-skills — Skills 系统概念(加载优先级、Gating、快照)
  • concepts/tool-skills-config — Skills 完整配置 schema
  • concepts/tool-creating-skills — 创建自定义 Skill