mirror of
https://github.com/openclaw/openclaw.git
synced 2026-05-29 00:06:48 +00:00
ee57f341f0
* feat(skills): fetch ClawHub skill verification * feat(skills): resolve ClawHub verification targets * feat(skills): add ClawHub verify command * docs(skills): document ClawHub verification * test(skills): type verify CLI fixture * fix(skills): fetch verified skill card URL * fix(skills): bound verified card downloads * fix(skills): fail closed on malformed verification * fix(skills): corroborate ClawHub install origins * feat(skills): surface ClawHub trust in control UI * chore(protocol): refresh generated gateway models * chore(ui): refresh i18n raw copy baseline * docs: clarify skills verify wording * fix: fail closed on skill trust mismatches * fix: reject incomplete clawhub provenance * fix: satisfy trust verdict lint * fix: restore ci checks after main merge
123 lines
5.4 KiB
Markdown
123 lines
5.4 KiB
Markdown
---
|
|
summary: "CLI reference for `openclaw skills` (search/install/update/verify/list/info/check)"
|
|
read_when:
|
|
- You want to see which skills are available and ready to run
|
|
- You want to search ClawHub or install skills from ClawHub, Git, or local directories
|
|
- You want to verify a ClawHub skill with ClawHub
|
|
- You want to debug missing binaries/env/config for skills
|
|
title: "Skills"
|
|
---
|
|
|
|
# `openclaw skills`
|
|
|
|
Inspect local skills, search ClawHub, install skills from ClawHub/Git/local
|
|
directories, verify ClawHub skills, and update ClawHub-tracked installs.
|
|
|
|
Related:
|
|
|
|
- Skills system: [Skills](/tools/skills)
|
|
- Skills config: [Skills config](/tools/skills-config)
|
|
- ClawHub installs: [ClawHub](/clawhub/cli)
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
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 verify <slug>
|
|
openclaw skills verify <slug> --version <version>
|
|
openclaw skills verify <slug> --tag <tag>
|
|
openclaw skills verify <slug> --card
|
|
openclaw skills verify <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
|
|
```
|
|
|
|
`search`, `update`, and `verify` use ClawHub directly. `install <slug>` installs
|
|
a ClawHub skill, `install git:owner/repo[@ref]` clones a Git skill, and
|
|
`install ./path` copies a local skill directory. By default, `install`, `update`,
|
|
and `verify` target the active workspace `skills/` directory; with `--global`,
|
|
they target the shared managed skills directory. `list`/`info`/`check` still
|
|
inspect the local skills visible to the current workspace and config.
|
|
Workspace-backed commands resolve the target workspace from `--agent <id>`, then
|
|
the current working directory when it is inside a configured agent workspace,
|
|
then the default agent.
|
|
|
|
Git and local directory installs expect `SKILL.md` at the source root. The
|
|
install slug comes from `SKILL.md` frontmatter `name` when it is valid, then the
|
|
source directory or repository name; use `--as <slug>` to override it. `--version`
|
|
is ClawHub-only. Skill installs do not support npm package specs or zip/archive
|
|
paths, and `openclaw skills update` updates ClawHub-tracked installs only.
|
|
|
|
Gateway-backed skill dependency installs triggered from onboarding or Skills
|
|
settings use the separate `skills.install` request path instead.
|
|
|
|
Notes:
|
|
|
|
- `search [query...]` accepts an optional query; omit it to browse the default
|
|
ClawHub search feed.
|
|
- `search --limit <n>` caps returned results.
|
|
- `install git:owner/repo[@ref]` installs a Git skill. Branch refs may contain
|
|
slashes, such as `git:owner/repo@feature/foo`.
|
|
- `install ./path/to/skill` installs a local directory whose root contains
|
|
`SKILL.md`.
|
|
- `install --as <slug>` overrides the inferred slug for Git and local directory
|
|
installs.
|
|
- `install --version <version>` applies only to ClawHub skill slugs.
|
|
- `install --force` overwrites an existing workspace skill folder for the same
|
|
slug.
|
|
- `--global` targets the shared managed skills directory and cannot be combined
|
|
with `--agent <id>`.
|
|
- `--agent <id>` targets one configured agent workspace and overrides current
|
|
working directory inference.
|
|
- `update <slug>` updates a single tracked skill. Add `--global` to target the
|
|
shared managed skills directory instead of the workspace.
|
|
- `update --all` updates tracked ClawHub installs in the selected workspace, or
|
|
in the shared managed skills directory when combined with `--global`.
|
|
- `verify <slug>` prints ClawHub's `clawhub.skill.verify.v1` JSON envelope by
|
|
default. There is no `--json` flag because JSON is already the default.
|
|
- `verify` uses `.clawhub/origin.json` for installed ClawHub skills, so it
|
|
verifies the installed version against the registry it came from. `--version`
|
|
and `--tag` override the version selector but keep that installed registry
|
|
when origin metadata exists.
|
|
- `verify --card` prints the generated Skill Card Markdown instead of JSON. The
|
|
command exits non-zero when ClawHub returns `ok: false` or `decision: "fail"`;
|
|
unsigned signatures are informational unless ClawHub policy changes.
|
|
- Installed ClawHub bundles can include a generated `skill-card.md`. OpenClaw
|
|
treats verification as a ClawHub server decision and does not reject an
|
|
installed skill just because that generated card changes the bundle
|
|
fingerprint.
|
|
- `check --agent <id>` checks the selected agent's workspace and reports which
|
|
ready skills are actually visible to that agent's prompt or command surface.
|
|
- `list` is the default action when no subcommand is provided.
|
|
- `list`, `info`, and `check` write their rendered output to stdout. With
|
|
`--json`, that means the machine-readable payload stays on stdout for pipes
|
|
and scripts.
|
|
|
|
## Related
|
|
|
|
- [CLI reference](/cli)
|
|
- [Skills](/tools/skills)
|