
























@@ -2,14 +2,15 @@
22summary: "CLI reference for `openclaw skills` (search/install/update/list/info/check)"
33read_when:
44 - You want to see which skills are available and ready to run
5- - You want to search, install, or update skills from ClawHub
5+ - You want to search ClawHub or install skills from ClawHub, Git, or local directories
66 - You want to debug missing binaries/env/config for skills
77title: "Skills"
88---
991010# `openclaw skills`
111112-Inspect local skills and install/update skills from ClawHub.
12+Inspect local skills, search ClawHub, install skills from ClawHub/Git/local directories, and update
13+ClawHub-tracked installs.
13141415Related:
1516@@ -24,6 +25,9 @@ openclaw skills search "calendar"
2425openclaw skills search --limit 20 --json
2526openclaw skills install <slug>
2627openclaw skills install <slug> --version <version>
28+openclaw skills install git:owner/repo
29+openclaw skills install git:owner/repo@main
30+openclaw skills install ./path/to/skill --as custom-name
2731openclaw skills install <slug> --force
2832openclaw skills install <slug> --agent <id>
2933openclaw skills install <slug> --global
@@ -45,23 +49,36 @@ openclaw skills check --agent <id>
4549openclaw skills check --json
4650```
475148-`search`/`install`/`update` use ClawHub directly. By default, `install` and
49-`update` target the active workspace `skills/` directory; with `--global`, they
50-target the shared managed skills directory. `list`/`info`/`check` still inspect
51-the local skills visible to the current workspace and config. Workspace-backed
52-commands resolve the target workspace from `--agent <id>`, then the current
53-working directory when it is inside a configured agent workspace, then the
54-default agent.
52+`search` and `update` use ClawHub directly. `install <slug>` installs a ClawHub
53+skill, `install git:owner/repo[@ref]` clones a Git skill, and `install ./path`
54+copies a local skill directory. By default, `install` and `update` target the
55+active workspace `skills/` directory; with `--global`, they target the shared
56+managed skills directory. `list`/`info`/`check` still inspect the local skills
57+visible to the current workspace and config. Workspace-backed commands resolve
58+the target workspace from `--agent <id>`, then the current working directory
59+when it is inside a configured agent workspace, then the default agent.
556056-This CLI `install` command downloads skill folders from ClawHub. Gateway-backed
57-skill dependency installs triggered from onboarding or Skills settings use the
58-separate `skills.install` request path instead.
61+Git and local directory installs expect `SKILL.md` at the source root. The
62+install slug comes from `SKILL.md` frontmatter `name` when it is valid, then the
63+source directory or repository name; use `--as <slug>` to override it. `--version`
64+is ClawHub-only. Skill installs do not support npm package specs or zip/archive
65+paths, and `openclaw skills update` updates ClawHub-tracked installs only.
66+67+Gateway-backed skill dependency installs triggered from onboarding or Skills
68+settings use the separate `skills.install` request path instead.
59696070Notes:
61716272- `search [query...]` accepts an optional query; omit it to browse the default
6373 ClawHub search feed.
6474- `search --limit <n>` caps returned results.
75+- `install git:owner/repo[@ref]` installs a Git skill. Branch refs may contain
76+ slashes, such as `git:owner/repo@feature/foo`.
77+- `install ./path/to/skill` installs a local directory whose root contains
78+`SKILL.md`.
79+- `install --as <slug>` overrides the inferred slug for Git and local directory
80+ installs.
81+- `install --version <version>` applies only to ClawHub skill slugs.
6582- `install --force` overwrites an existing workspace skill folder for the same
6683 slug.
6784- `--global` targets the shared managed skills directory and cannot be combined
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。