2026-01-15 06:12:54 +00:00
|
|
|
---
|
2026-03-22 17:03:32 +00:00
|
|
|
summary: "CLI reference for `openclaw skills` (search/install/update/list/info/check)"
|
2026-01-15 06:12:54 +00:00
|
|
|
read_when:
|
|
|
|
|
- You want to see which skills are available and ready to run
|
2026-03-22 17:03:32 +00:00
|
|
|
- You want to search, install, or update skills from ClawHub
|
2026-01-15 06:12:54 +00:00
|
|
|
- You want to debug missing binaries/env/config for skills
|
2026-01-31 16:04:03 -05:00
|
|
|
title: "skills"
|
2026-01-15 06:12:54 +00:00
|
|
|
---
|
|
|
|
|
|
2026-01-30 03:15:10 +01:00
|
|
|
# `openclaw skills`
|
2026-01-15 06:12:54 +00:00
|
|
|
|
2026-03-22 17:03:32 +00:00
|
|
|
Inspect local skills and install/update skills from ClawHub.
|
2026-01-15 06:12:54 +00:00
|
|
|
|
|
|
|
|
Related:
|
2026-01-31 21:13:13 +09:00
|
|
|
|
2026-01-15 06:12:54 +00:00
|
|
|
- Skills system: [Skills](/tools/skills)
|
|
|
|
|
- Skills config: [Skills config](/tools/skills-config)
|
2026-01-30 21:01:02 +01:00
|
|
|
- ClawHub installs: [ClawHub](/tools/clawhub)
|
2026-01-15 06:12:54 +00:00
|
|
|
|
|
|
|
|
## Commands
|
|
|
|
|
|
|
|
|
|
```bash
|
2026-03-22 17:03:32 +00:00
|
|
|
openclaw skills search "calendar"
|
2026-04-04 13:31:13 +01:00
|
|
|
openclaw skills search --limit 20 --json
|
2026-03-22 17:03:32 +00:00
|
|
|
openclaw skills install <slug>
|
|
|
|
|
openclaw skills install <slug> --version <version>
|
2026-04-04 13:31:13 +01:00
|
|
|
openclaw skills install <slug> --force
|
2026-03-22 17:03:32 +00:00
|
|
|
openclaw skills update <slug>
|
|
|
|
|
openclaw skills update --all
|
2026-01-30 03:15:10 +01:00
|
|
|
openclaw skills list
|
|
|
|
|
openclaw skills list --eligible
|
2026-04-04 13:31:13 +01:00
|
|
|
openclaw skills list --json
|
|
|
|
|
openclaw skills list --verbose
|
2026-01-30 03:15:10 +01:00
|
|
|
openclaw skills info <name>
|
2026-04-04 13:31:13 +01:00
|
|
|
openclaw skills info <name> --json
|
2026-01-30 03:15:10 +01:00
|
|
|
openclaw skills check
|
2026-04-04 13:31:13 +01:00
|
|
|
openclaw skills check --json
|
2026-01-15 06:12:54 +00:00
|
|
|
```
|
2026-03-22 17:03:32 +00:00
|
|
|
|
|
|
|
|
`search`/`install`/`update` use ClawHub directly and install into the active
|
|
|
|
|
workspace `skills/` directory. `list`/`info`/`check` still inspect the local
|
|
|
|
|
skills visible to the current workspace and config.
|
2026-03-31 23:27:10 +09:00
|
|
|
|
|
|
|
|
This CLI `install` command downloads skill folders from ClawHub. Gateway-backed
|
|
|
|
|
skill dependency installs triggered from onboarding or Skills settings use the
|
|
|
|
|
separate `skills.install` request path instead.
|
2026-04-04 13:31:13 +01:00
|
|
|
|
|
|
|
|
Notes:
|
|
|
|
|
|
|
|
|
|
- `search [query...]` accepts an optional query; omit it to browse the default
|
|
|
|
|
ClawHub search feed.
|
|
|
|
|
- `search --limit <n>` caps returned results.
|
|
|
|
|
- `install --force` overwrites an existing workspace skill folder for the same
|
|
|
|
|
slug.
|
|
|
|
|
- `update --all` only updates tracked ClawHub installs in the active workspace.
|
|
|
|
|
- `list` is the default action when no subcommand is provided.
|
2026-04-04 16:19:34 +01:00
|
|
|
- `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.
|
