Skip to content

Commit 91b2800

Browse files
steipetesteipete
committed
feat: add native clawhub install flows
1 parent c778877 commit 91b2800

25 files changed

Lines changed: 2471 additions & 208 deletions

‎CHANGELOG.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@ Docs: https://docs.openclaw.ai
66

77
### Changes
88

9+
- ClawHub/install: add native `openclaw skills search|install|update` flows plus `openclaw plugins install clawhub:<package>` with tracked update metadata, gateway skill-install/update support for ClawHub-backed requests, and regression coverage/docs for the new source path.
910
- Models/Anthropic Vertex: add core `anthropic-vertex` provider support for Claude via Google Vertex AI, including GCP auth/discovery and main run-path routing. (#43356) Thanks @sallyom and @yossiovadia.
1011
- Commands/btw: add `/btw` side questions for quick tool-less answers about the current session without changing future session context, with dismissible in-session TUI answers and explicit BTW replies on external channels. (#45444) Thanks @ngutman.
1112
- Gateway/docs: clarify that empty URL input allowlists are treated as unset, document `allowUrl: false` as the deny-all switch, and add regression coverage for the normalization path.

‎docs/cli/index.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -485,6 +485,9 @@ List and inspect available skills plus readiness info.
485485

486486
Subcommands:
487487

488+
- `skills search [query...]`: search ClawHub skills.
489+
- `skills install <slug>`: install a skill from ClawHub into the active workspace.
490+
- `skills update <slug|--all>`: update tracked ClawHub skills.
488491
- `skills list`: list skills (default when no subcommand).
489492
- `skills info <name>`: show details for one skill.
490493
- `skills check`: summary of ready vs missing requirements.
@@ -495,7 +498,7 @@ Options:
495498
- `--json`: output JSON (no styling).
496499
- `-v`, `--verbose`: include missing requirements detail.
497500

498-
Tip: use `npx clawhub` to search, install, and sync skills.
501+
Tip: use `openclaw skills search`, `openclaw skills install`, and `openclaw skills update` for ClawHub-backed skills.
499502

500503
### `pairing`
501504

‎docs/cli/plugins.md‎

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,7 @@ capabilities.
4848
```bash
4949
openclaw plugins install <path-or-spec>
5050
openclaw plugins install <npm-spec> --pin
51+
openclaw plugins install clawhub:<package>
5152
openclaw plugins install <plugin>@<marketplace>
5253
openclaw plugins install <plugin> --marketplace <marketplace>
5354
```
@@ -71,6 +72,18 @@ Supported archives: `.zip`, `.tgz`, `.tar.gz`, `.tar`.
7172

7273
Claude marketplace installs are also supported.
7374

75+
ClawHub installs use an explicit `clawhub:<package>` locator:
76+
77+
```bash
78+
openclaw plugins install clawhub:openclaw-codex-app-server
79+
openclaw plugins install clawhub:openclaw-codex-app-server@1.2.3
80+
```
81+
82+
OpenClaw downloads the package archive from ClawHub, checks the advertised
83+
plugin API / minimum gateway compatibility, then installs it through the normal
84+
archive path. Recorded installs keep their ClawHub source metadata for later
85+
updates.
86+
7487
Use `plugin@marketplace` shorthand when the marketplace name exists in Claude's
7588
local registry cache at `~/.claude/plugins/known_marketplaces.json`:
7689

@@ -144,8 +157,8 @@ openclaw plugins update <id-or-npm-spec> --dry-run
144157
openclaw plugins update @openclaw/voice-call@beta
145158
```
146159

147-
Updates apply to tracked installs in `plugins.installs`, currently npm and
148-
marketplace installs.
160+
Updates apply to tracked installs in `plugins.installs`, including npm,
161+
ClawHub, and marketplace installs.
149162

150163
When you pass a plugin id, OpenClaw reuses the recorded install spec for that
151164
plugin. That means previously stored dist-tags such as `@beta` and exact pinned

‎docs/cli/skills.md‎

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
---
2-
summary: "CLI reference for `openclaw skills` (list/info/check) and skill eligibility"
2+
summary: "CLI reference for `openclaw skills` (search/install/update/list/info/check)"
33
read_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
56
- You want to debug missing binaries/env/config for skills
67
title: "skills"
78
---
89

910
# `openclaw skills`
1011

11-
Inspect skills (bundled + workspace + managed overrides) and see what’s eligible vs missing requirements.
12+
Inspect local skills and install/update skills from ClawHub.
1213

1314
Related:
1415

@@ -19,8 +20,17 @@ Related:
1920
## Commands
2021

2122
```bash
23+
openclaw skills search "calendar"
24+
openclaw skills install <slug>
25+
openclaw skills install <slug> --version <version>
26+
openclaw skills update <slug>
27+
openclaw skills update --all
2228
openclaw skills list
2329
openclaw skills list --eligible
2430
openclaw skills info <name>
2531
openclaw skills check
2632
```
33+
34+
`search`/`install`/`update` use ClawHub directly and install into the active
35+
workspace `skills/` directory. `list`/`info`/`check` still inspect the local
36+
skills visible to the current workspace and config.

‎docs/help/faq.md‎

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -992,18 +992,16 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
992992
</Accordion>
993993

994994
<Accordion title="How do I install skills on Linux?">
995-
Use **ClawHub** (CLI) or drop skills into your workspace. The macOS Skills UI isn't available on Linux.
995+
Use native `openclaw skills` commands or drop skills into your workspace. The macOS Skills UI isn't available on Linux.
996996
Browse skills at [https://clawhub.com](https://clawhub.com).
997997

998-
Install the ClawHub CLI (pick one package manager):
999-
1000998
```bash
1001-
npm i -g clawhub
999+
openclaw skills search "calendar"
1000+
openclaw skills install <skill-slug>
1001+
openclaw skills update --all
10021002
```
10031003

1004-
```bash
1005-
pnpm add -g clawhub
1006-
```
1004+
Install the separate `clawhub` CLI only if you want to publish or sync your own skills.
10071005

10081006
</Accordion>
10091007

@@ -1075,11 +1073,11 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
10751073
Install skills:
10761074

10771075
```bash
1078-
clawhub install <skill-slug>
1079-
clawhub update --all
1076+
openclaw skills install <skill-slug>
1077+
openclaw skills update --all
10801078
```
10811079

1082-
ClawHub installs into `./skills` under your current directory (or falls back to your configured OpenClaw workspace); OpenClaw treats that as `<workspace>/skills` on the next session. For shared skills across agents, place them in `~/.openclaw/skills/<name>/SKILL.md`. Some skills expect binaries installed via Homebrew; on Linux that means Linuxbrew (see the Homebrew Linux FAQ entry above). See [Skills](/tools/skills) and [ClawHub](/tools/clawhub).
1080+
Native installs land in the active workspace `skills/` directory. For shared skills across agents, place them in `~/.openclaw/skills/<name>/SKILL.md`. Some skills expect binaries installed via Homebrew; on Linux that means Linuxbrew (see the Homebrew Linux FAQ entry above). See [Skills](/tools/skills) and [ClawHub](/tools/clawhub).
10831081

10841082
</Accordion>
10851083

‎docs/tools/clawhub.md‎

Lines changed: 46 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
summary: "ClawHub guide: public skills registry + CLI workflows"
2+
summary: "ClawHub guide: public registry, native OpenClaw install flows, and ClawHub CLI workflows"
33
read_when:
44
- Introducing ClawHub to new users
55
- Installing, searching, or publishing skills
@@ -9,10 +9,35 @@ title: "ClawHub"
99

1010
# ClawHub
1111

12-
ClawHub is the **public skill registry for OpenClaw**. It is a free service: all skills are public, open, and visible to everyone for sharing and reuse. A skill is just a folder with a `SKILL.md` file (plus supporting text files). You can browse skills in the web app or use the CLI to search, install, update, and publish skills.
12+
ClawHub is the public registry for **OpenClaw skills and plugins**.
13+
14+
- Use native `openclaw` commands to search/install/update skills and install
15+
plugins from ClawHub.
16+
- Use the separate `clawhub` CLI when you need registry auth, publish, delete,
17+
undelete, or sync workflows.
1318

1419
Site: [clawhub.ai](https://clawhub.ai)
1520

21+
## Native OpenClaw flows
22+
23+
Skills:
24+
25+
```bash
26+
openclaw skills search "calendar"
27+
openclaw skills install <skill-slug>
28+
openclaw skills update --all
29+
```
30+
31+
Plugins:
32+
33+
```bash
34+
openclaw plugins install clawhub:<package>
35+
openclaw plugins update --all
36+
```
37+
38+
Native `openclaw` commands install into your active workspace and persist source
39+
metadata so later `update` calls can stay on ClawHub.
40+
1641
## What ClawHub is
1742

1843
- A public registry for OpenClaw skills.
@@ -45,16 +70,17 @@ If you want to add new capabilities to your OpenClaw agent, ClawHub is the easie
4570

4671
## Quick start (non-technical)
4772

48-
1. Install the CLI (see next section).
49-
2. Search for something you need:
50-
- `clawhub search "calendar"`
51-
3. Install a skill:
52-
- `clawhub install <skill-slug>`
53-
4. Start a new OpenClaw session so it picks up the new skill.
73+
1. Search for something you need:
74+
- `openclaw skills search "calendar"`
75+
2. Install a skill:
76+
- `openclaw skills install <skill-slug>`
77+
3. Start a new OpenClaw session so it picks up the new skill.
78+
4. If you want to publish or manage registry auth, install the separate
79+
`clawhub` CLI too.
5480

55-
## Install the CLI
81+
## Install the ClawHub CLI
5682

57-
Pick one:
83+
You only need this for registry-authenticated workflows such as publish/sync:
5884

5985
```bash
6086
npm i -g clawhub
@@ -66,7 +92,16 @@ pnpm add -g clawhub
6692

6793
## How it fits into OpenClaw
6894

69-
By default, the CLI installs skills into `./skills` under your current working directory. If an OpenClaw workspace is configured, `clawhub` falls back to that workspace unless you override `--workdir` (or `CLAWHUB_WORKDIR`). OpenClaw loads workspace skills from `<workspace>/skills` and will pick them up in the **next** session. If you already use `~/.openclaw/skills` or bundled skills, workspace skills take precedence.
95+
Native `openclaw skills install` installs into the active workspace `skills/`
96+
directory. `openclaw plugins install clawhub:...` records a normal managed
97+
plugin install plus ClawHub source metadata for updates.
98+
99+
The separate `clawhub` CLI also installs skills into `./skills` under your
100+
current working directory. If an OpenClaw workspace is configured, `clawhub`
101+
falls back to that workspace unless you override `--workdir` (or
102+
`CLAWHUB_WORKDIR`). OpenClaw loads workspace skills from `<workspace>/skills`
103+
and will pick them up in the **next** session. If you already use
104+
`~/.openclaw/skills` or bundled skills, workspace skills take precedence.
70105

71106
For more detail on how skills are loaded, shared, and gated, see
72107
[Skills](/tools/skills).

‎docs/tools/skills.md‎

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -50,21 +50,24 @@ tool surface those skills teach.
5050
## ClawHub (install + sync)
5151

5252
ClawHub is the public skills registry for OpenClaw. Browse at
53-
[https://clawhub.com](https://clawhub.com). Use it to discover, install, update, and back up skills.
53+
[https://clawhub.com](https://clawhub.com). Use native `openclaw skills`
54+
commands to discover/install/update skills, or the separate `clawhub` CLI when
55+
you need publish/sync workflows.
5456
Full guide: [ClawHub](/tools/clawhub).
5557

5658
Common flows:
5759

5860
- Install a skill into your workspace:
59-
- `clawhub install <skill-slug>`
61+
- `openclaw skills install <skill-slug>`
6062
- Update all installed skills:
61-
- `clawhub update --all`
63+
- `openclaw skills update --all`
6264
- Sync (scan + publish updates):
6365
- `clawhub sync --all`
6466

65-
By default, `clawhub` installs into `./skills` under your current working
66-
directory (or falls back to the configured OpenClaw workspace). OpenClaw picks
67-
that up as `<workspace>/skills` on the next session.
67+
Native `openclaw skills install` installs into the active workspace `skills/`
68+
directory. The separate `clawhub` CLI also installs into `./skills` under your
69+
current working directory (or falls back to the configured OpenClaw workspace).
70+
OpenClaw picks that up as `<workspace>/skills` on the next session.
6871

6972
## Security notes
7073

0 commit comments

Comments
 (0)