openclaw skills 是 OpenClaw 的 Skill 管理命令组，用于从 ClawHub 搜索/安装/更新技能，也能从 Git 仓库或本地目录安装。搜索和安装依赖 ClawHub 在线服务；list、info、check 直接检查本地工作区或全局目录中的技能状态。默认安装到当前工作区的 skills/ 目录，加 --global 则安装到共享管理的技能目录。install 只支持 ClawHub slug、Git 仓库或本地目录，不支持 npm 包或 zip 压缩包。

openclaw skills：Skill 搜索、安装、更新、检查命令大全

查看本地可见的技能、搜索 ClawHub、从 ClawHub/Git/本地目录安装技能，以及更新已通过 ClawHub 安装的技能。

相关文档：

• Skills 系统：Skills
• Skills 配置：Skills config
• ClawHub 安装说明：ClawHub

子命令一览

# 搜索
openclaw skills search "calendar"
openclaw skills search --limit 20 --json

# 安装
openclaw skills install <slug>
openclaw skills install <slug> --version <version>
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 <slug> --force
openclaw skills install <slug> --agent <id>
openclaw skills install <slug> --global

# 更新
openclaw skills update <slug>
openclaw skills update <slug> --global
openclaw skills update --all
openclaw skills update --all --agent <id>
openclaw skills update --all --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

search 和 update 直接使用 ClawHub 服务。install <slug> 安装 ClawHub 上的技能；install git:owner/repo[@ref] 克隆 Git 仓库中的技能；install ./path 复制本地技能目录。

默认情况下，install 和 update 操作当前工作区的 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 跟踪安装的技能。

Gateway 后台触发的技能依赖安装（例如从 onboarding 流程或 Skills 设置）走的是独立的 skills.install 请求路径，与 CLI 命令不同。

参数详解

• 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 技能 slug。
• install --force：覆盖工作区中已存在的同名技能文件夹。
• --global：目标为共享管理的技能目录，不能与 --agent <id> 同时使用。
• --agent <id>：目标为指定智能体的工作区，会覆盖当前工作目录的自动推断。
• update <slug>：更新单个已跟踪的技能。加上 --global 则更新共享管理的技能目录中的技能，而不是工作区中的。
• update --all：更新所选工作区中所有已跟踪的 ClawHub 安装；加上 --global 则更新共享管理的技能目录中的技能。
• check --agent <id>：检查指定智能体工作区中的技能，报告哪些就绪的技能在该智能体的提示或命令表面中实际可见。
• list 是默认动作（不输入子命令时默认执行）。
• list、info、check 输出到 stdout；使用 --json 时，机器可读的 JSON 也输出到 stdout，方便管道和脚本处理。

相关文档

• CLI 参考
• Skills 系统

常见问题

搜索技能时返回为空怎么办？

确保当前设备能访问 ClawHub 服务。如果网络正常但无结果，尝试不带查询词运行 openclaw skills search 浏览默认推荐列表。如果仍然为空，检查 ClawHub 是否配置正确（参考 ClawHub）。

安装 Git 技能时报错 "SKILL.md not found" 怎么处理？

Git 仓库根目录必须包含 SKILL.md 文件。确认仓库结构；如果仓库中没有 SKILL.md，则无法通过 CLI 安装。可以尝试手动克隆并将 SKILL.md 放到根目录，然后使用本地目录安装方式 openclaw skills install ./路径 --as <slug>。

openclaw skills update --all 不更新某些技能，可能是什么原因？

update 只更新通过 ClawHub 跟踪安装的技能。如果技能是从 Git 或本地目录安装的，无法通过 update 更新，需要重新安装。另外，--global 与 --agent 不能混用，确认目标是否正确。可以先用 openclaw skills list --verbose 查看每个技能的安装来源。