@qingchencloud/openclaw-zh 2026.1.29-nightly.202601301956 → 2026.1.29-nightly.202601302059
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -9
- package/README.md +86 -20
- package/dist/agents/system-prompt.js +1 -1
- package/dist/build-info.json +3 -3
- package/dist/canvas-host/a2ui/.bundle.hash +1 -1
- package/dist/cli/cli-utils.js +10 -0
- package/dist/cli/models-cli.js +20 -8
- package/dist/cli/skills-cli.js +7 -7
- package/dist/commands/models/auth-order.js +2 -2
- package/dist/commands/models/list.status-command.js +37 -17
- package/dist/commands/models/shared.js +14 -0
- package/dist/control-ui/assets/{index-CNKLKKXX.js → index-Bpe27rQF.js} +2 -2
- package/dist/control-ui/assets/{index-CNKLKKXX.js.map → index-Bpe27rQF.js.map} +1 -1
- package/dist/control-ui/index.html +1 -1
- package/docs/cli/index.md +1 -1
- package/docs/cli/models.md +4 -0
- package/docs/cli/skills.md +1 -2
- package/docs/concepts/agent.md +2 -2
- package/docs/concepts/system-prompt.md +1 -1
- package/docs/docs.json +10 -2
- package/docs/help/faq.md +16 -16
- package/docs/install/installer.md +2 -2
- package/docs/providers/github-copilot.md +1 -1
- package/docs/start/hubs.md +1 -1
- package/docs/start/lore.md +1 -1
- package/docs/start/showcase.md +14 -14
- package/docs/start/wizard.md +8 -8
- package/docs/tools/{clawdhub.md → clawhub.md} +39 -39
- package/docs/tools/creating-skills.md +1 -1
- package/docs/tools/skills.md +9 -9
- package/package.json +1 -1
- package/skills/1password/SKILL.md +1 -1
- package/skills/bluebubbles/SKILL.md +1 -1
- package/skills/canvas/SKILL.md +3 -3
- package/skills/clawhub/SKILL.md +53 -0
- package/skills/nano-banana-pro/SKILL.md +1 -1
- package/skills/openai-whisper-api/SKILL.md +1 -1
- package/skills/session-logs/SKILL.md +6 -6
- package/skills/sherpa-onnx-tts/SKILL.md +6 -6
- package/skills/tmux/SKILL.md +4 -4
- package/skills/tmux/scripts/find-sessions.sh +2 -2
- package/skills/clawdhub/SKILL.md +0 -53
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
<link rel="icon" type="image/svg+xml" href="./favicon.svg" />
|
|
9
9
|
<link rel="icon" type="image/png" sizes="32x32" href="./favicon-32.png" />
|
|
10
10
|
<link rel="apple-touch-icon" sizes="180x180" href="./apple-touch-icon.png" />
|
|
11
|
-
<script type="module" crossorigin src="./assets/index-
|
|
11
|
+
<script type="module" crossorigin src="./assets/index-Bpe27rQF.js"></script>
|
|
12
12
|
<link rel="stylesheet" crossorigin href="./assets/index-BKPyesll.css">
|
|
13
13
|
</head>
|
|
14
14
|
<body>
|
package/docs/cli/index.md
CHANGED
|
@@ -414,7 +414,7 @@ Options:
|
|
|
414
414
|
- `--json`: output JSON (no styling).
|
|
415
415
|
- `-v`, `--verbose`: include missing requirements detail.
|
|
416
416
|
|
|
417
|
-
Tip: use `npx
|
|
417
|
+
Tip: use `npx clawhub` to search, install, and sync skills.
|
|
418
418
|
|
|
419
419
|
### `pairing`
|
|
420
420
|
Approve DM pairing requests across channels.
|
package/docs/cli/models.md
CHANGED
|
@@ -27,6 +27,9 @@ When provider usage snapshots are available, the OAuth/token status section incl
|
|
|
27
27
|
provider usage headers.
|
|
28
28
|
Add `--probe` to run live auth probes against each configured provider profile.
|
|
29
29
|
Probes are real requests (may consume tokens and trigger rate limits).
|
|
30
|
+
Use `--agent <id>` to inspect a configured agent’s model/auth state. When omitted,
|
|
31
|
+
the command uses `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR` if set, otherwise the
|
|
32
|
+
configured default agent.
|
|
30
33
|
|
|
31
34
|
Notes:
|
|
32
35
|
- `models set <model-or-alias>` accepts `provider/model` or an alias.
|
|
@@ -44,6 +47,7 @@ Options:
|
|
|
44
47
|
- `--probe-timeout <ms>`
|
|
45
48
|
- `--probe-concurrency <n>`
|
|
46
49
|
- `--probe-max-tokens <n>`
|
|
50
|
+
- `--agent <id>` (configured agent id; overrides `OPENCLAW_AGENT_DIR`/`PI_CODING_AGENT_DIR`)
|
|
47
51
|
|
|
48
52
|
## Aliases + fallbacks
|
|
49
53
|
|
package/docs/cli/skills.md
CHANGED
|
@@ -12,7 +12,7 @@ Inspect skills (bundled + workspace + managed overrides) and see what’s eligib
|
|
|
12
12
|
Related:
|
|
13
13
|
- Skills system: [Skills](/tools/skills)
|
|
14
14
|
- Skills config: [Skills config](/tools/skills-config)
|
|
15
|
-
-
|
|
15
|
+
- ClawHub installs: [ClawHub](/tools/clawhub)
|
|
16
16
|
|
|
17
17
|
## Commands
|
|
18
18
|
|
|
@@ -22,4 +22,3 @@ openclaw skills list --eligible
|
|
|
22
22
|
openclaw skills info <name>
|
|
23
23
|
openclaw skills check
|
|
24
24
|
```
|
|
25
|
-
|
package/docs/concepts/agent.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
---
|
|
2
|
-
summary: "Agent runtime (embedded
|
|
2
|
+
summary: "Agent runtime (embedded pi-mono), workspace contract, and session bootstrap"
|
|
3
3
|
read_when:
|
|
4
4
|
- Changing agent runtime, workspace bootstrap, or session behavior
|
|
5
5
|
---
|
|
6
6
|
# Agent Runtime 🤖
|
|
7
7
|
|
|
8
|
-
OpenClaw runs a single embedded agent runtime derived from **
|
|
8
|
+
OpenClaw runs a single embedded agent runtime derived from **pi-mono**.
|
|
9
9
|
|
|
10
10
|
## Workspace (required)
|
|
11
11
|
|
|
@@ -105,6 +105,6 @@ This keeps the base prompt small while still enabling targeted skill usage.
|
|
|
105
105
|
When available, the system prompt includes a **Documentation** section that points to the
|
|
106
106
|
local OpenClaw docs directory (either `docs/` in the repo workspace or the bundled npm
|
|
107
107
|
package docs) and also notes the public mirror, source repo, community Discord, and
|
|
108
|
-
|
|
108
|
+
ClawHub (https://clawhub.com) for skills discovery. The prompt instructs the model to consult local docs first
|
|
109
109
|
for OpenClaw behavior, commands, configuration, or architecture, and to run
|
|
110
110
|
`openclaw status` itself when possible (asking the user only when it lacks access).
|
package/docs/docs.json
CHANGED
|
@@ -369,9 +369,17 @@
|
|
|
369
369
|
"source": "/start/clawd/",
|
|
370
370
|
"destination": "/start/openclaw"
|
|
371
371
|
},
|
|
372
|
+
{
|
|
373
|
+
"source": "/clawhub",
|
|
374
|
+
"destination": "/tools/clawhub"
|
|
375
|
+
},
|
|
372
376
|
{
|
|
373
377
|
"source": "/clawdhub",
|
|
374
|
-
"destination": "/tools/
|
|
378
|
+
"destination": "/tools/clawhub"
|
|
379
|
+
},
|
|
380
|
+
{
|
|
381
|
+
"source": "/tools/clawdhub",
|
|
382
|
+
"destination": "/tools/clawhub"
|
|
375
383
|
},
|
|
376
384
|
{
|
|
377
385
|
"source": "/configuration",
|
|
@@ -1073,7 +1081,7 @@
|
|
|
1073
1081
|
"tools/reactions",
|
|
1074
1082
|
"tools/skills",
|
|
1075
1083
|
"tools/skills-config",
|
|
1076
|
-
"tools/
|
|
1084
|
+
"tools/clawhub"
|
|
1077
1085
|
]
|
|
1078
1086
|
},
|
|
1079
1087
|
{
|
package/docs/help/faq.md
CHANGED
|
@@ -291,7 +291,7 @@ Other useful CLI checks: `openclaw status --all`, `openclaw logs --follow`,
|
|
|
291
291
|
Quick debug loop: [First 60 seconds if something's broken](#first-60-seconds-if-somethings-broken).
|
|
292
292
|
Install docs: [Install](/install), [Installer flags](/install/installer), [Updating](/install/updating).
|
|
293
293
|
|
|
294
|
-
###
|
|
294
|
+
### What's the recommended way to install and set up OpenClaw
|
|
295
295
|
|
|
296
296
|
The repo recommends running from source and using the onboarding wizard:
|
|
297
297
|
|
|
@@ -424,7 +424,7 @@ Please help us unblock it by reporting here: https://spa.xfinity.com/check_url_s
|
|
|
424
424
|
If you still can't reach the site, the docs are mirrored on GitHub:
|
|
425
425
|
https://github.com/openclaw/openclaw/tree/main/docs
|
|
426
426
|
|
|
427
|
-
###
|
|
427
|
+
### What's the difference between stable and beta
|
|
428
428
|
|
|
429
429
|
**Stable** and **beta** are **npm dist‑tags**, not separate code lines:
|
|
430
430
|
- `latest` = stable
|
|
@@ -784,7 +784,7 @@ brew install <formula>
|
|
|
784
784
|
If you run OpenClaw via systemd, ensure the service PATH includes `/home/linuxbrew/.linuxbrew/bin` (or your brew prefix) so `brew`-installed tools resolve in non‑login shells.
|
|
785
785
|
Recent builds also prepend common user bin dirs on Linux systemd services (for example `~/.local/bin`, `~/.npm-global/bin`, `~/.local/share/pnpm`, `~/.bun/bin`) and honor `PNPM_HOME`, `NPM_CONFIG_PREFIX`, `BUN_INSTALL`, `VOLTA_HOME`, `ASDF_DATA_DIR`, `NVM_DIR`, and `FNM_DIR` when set.
|
|
786
786
|
|
|
787
|
-
###
|
|
787
|
+
### What's the difference between the hackable git install and npm install
|
|
788
788
|
|
|
789
789
|
- **Hackable (git) install:** full source checkout, editable, best for contributors.
|
|
790
790
|
You run builds locally and can patch code/docs.
|
|
@@ -880,7 +880,7 @@ If you are running macOS in a VM, see [macOS VM](/platforms/macos-vm).
|
|
|
880
880
|
|
|
881
881
|
OpenClaw is a personal AI assistant you run on your own devices. It replies on the messaging surfaces you already use (WhatsApp, Telegram, Slack, Mattermost (plugin), Discord, Google Chat, Signal, iMessage, WebChat) and can also do voice + a live Canvas on supported platforms. The **Gateway** is the always-on control plane; the assistant is the product.
|
|
882
882
|
|
|
883
|
-
###
|
|
883
|
+
### What's the value proposition
|
|
884
884
|
|
|
885
885
|
OpenClaw is not “just a Claude wrapper.” It’s a **local-first control plane** that lets you run a
|
|
886
886
|
capable assistant on **your own hardware**, reachable from the chat apps you already use, with
|
|
@@ -956,7 +956,7 @@ Use managed overrides instead of editing the repo copy. Put your changes in `~/.
|
|
|
956
956
|
|
|
957
957
|
### Can I load skills from a custom folder
|
|
958
958
|
|
|
959
|
-
Yes. Add extra directories via `skills.load.extraDirs` in `~/.openclaw/openclaw.json` (lowest precedence). Default precedence remains: `<workspace>/skills` → `~/.openclaw/skills` → bundled → `skills.load.extraDirs`. `
|
|
959
|
+
Yes. Add extra directories via `skills.load.extraDirs` in `~/.openclaw/openclaw.json` (lowest precedence). Default precedence remains: `<workspace>/skills` → `~/.openclaw/skills` → bundled → `skills.load.extraDirs`. `clawhub` installs into `./skills` by default, which OpenClaw treats as `<workspace>/skills`.
|
|
960
960
|
|
|
961
961
|
### How can I use different models for different tasks
|
|
962
962
|
|
|
@@ -1000,17 +1000,17 @@ Docs: [Cron jobs](/automation/cron-jobs), [Cron vs Heartbeat](/automation/cron-v
|
|
|
1000
1000
|
|
|
1001
1001
|
### How do I install skills on Linux
|
|
1002
1002
|
|
|
1003
|
-
Use **
|
|
1004
|
-
Browse skills at https://
|
|
1003
|
+
Use **ClawHub** (CLI) or drop skills into your workspace. The macOS Skills UI isn’t available on Linux.
|
|
1004
|
+
Browse skills at https://clawhub.com.
|
|
1005
1005
|
|
|
1006
|
-
Install the
|
|
1006
|
+
Install the ClawHub CLI (pick one package manager):
|
|
1007
1007
|
|
|
1008
1008
|
```bash
|
|
1009
|
-
npm i -g
|
|
1009
|
+
npm i -g clawhub
|
|
1010
1010
|
```
|
|
1011
1011
|
|
|
1012
1012
|
```bash
|
|
1013
|
-
pnpm add -g
|
|
1013
|
+
pnpm add -g clawhub
|
|
1014
1014
|
```
|
|
1015
1015
|
|
|
1016
1016
|
### Can OpenClaw run tasks on a schedule or continuously in the background
|
|
@@ -1076,11 +1076,11 @@ targeting those APIs.
|
|
|
1076
1076
|
Install skills:
|
|
1077
1077
|
|
|
1078
1078
|
```bash
|
|
1079
|
-
|
|
1080
|
-
|
|
1079
|
+
clawhub install <skill-slug>
|
|
1080
|
+
clawhub update --all
|
|
1081
1081
|
```
|
|
1082
1082
|
|
|
1083
|
-
|
|
1083
|
+
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).
|
|
1084
1084
|
|
|
1085
1085
|
### How do I install the Chrome extension for browser takeover
|
|
1086
1086
|
|
|
@@ -1230,7 +1230,7 @@ AGENTS.md or MEMORY.md** rather than relying on chat history.
|
|
|
1230
1230
|
|
|
1231
1231
|
See [Agent workspace](/concepts/agent-workspace) and [Memory](/concepts/memory).
|
|
1232
1232
|
|
|
1233
|
-
###
|
|
1233
|
+
### What's the recommended backup strategy
|
|
1234
1234
|
|
|
1235
1235
|
Put your **agent workspace** in a **private** git repo and back it up somewhere
|
|
1236
1236
|
private (for example GitHub private). This captures memory + AGENTS/SOUL/USER
|
|
@@ -1526,7 +1526,7 @@ Avoid it:
|
|
|
1526
1526
|
|
|
1527
1527
|
Docs: [Config](/cli/config), [Configure](/cli/configure), [Doctor](/gateway/doctor).
|
|
1528
1528
|
|
|
1529
|
-
###
|
|
1529
|
+
### What's a minimal sane config for a first install
|
|
1530
1530
|
|
|
1531
1531
|
```json5
|
|
1532
1532
|
{
|
|
@@ -2522,7 +2522,7 @@ Docs: [Gateway service runbook](/gateway).
|
|
|
2522
2522
|
If you installed the service, use the gateway commands. Use `openclaw gateway` when
|
|
2523
2523
|
you want a one-off, foreground run.
|
|
2524
2524
|
|
|
2525
|
-
###
|
|
2525
|
+
### What's the fastest way to get more details when something fails
|
|
2526
2526
|
|
|
2527
2527
|
Start the Gateway with `--verbose` to get more console detail. Then inspect the log file for channel auth, model routing, and RPC errors.
|
|
2528
2528
|
|
|
@@ -37,7 +37,7 @@ What it does (high level):
|
|
|
37
37
|
- Choose install method:
|
|
38
38
|
- `npm` (default): `npm install -g openclaw@latest`
|
|
39
39
|
- `git`: clone/build a source checkout and install a wrapper script
|
|
40
|
-
- On Linux: avoid global npm permission errors by switching npm
|
|
40
|
+
- On Linux: avoid global npm permission errors by switching npm's prefix to `~/.npm-global` when needed.
|
|
41
41
|
- If upgrading an existing install: runs `openclaw doctor --non-interactive` (best effort).
|
|
42
42
|
- For git installs: runs `openclaw doctor --non-interactive` after install/update (best effort).
|
|
43
43
|
- Mitigates `sharp` native install gotchas by defaulting `SHARP_IGNORE_GLOBAL_LIBVIPS=1` (avoids building against system libvips).
|
|
@@ -65,7 +65,7 @@ For `npm` installs, Git is *usually* not required, but some environments still e
|
|
|
65
65
|
|
|
66
66
|
### Why npm hits `EACCES` on fresh Linux
|
|
67
67
|
|
|
68
|
-
On some Linux setups (especially after installing Node via the system package manager or NodeSource), npm
|
|
68
|
+
On some Linux setups (especially after installing Node via the system package manager or NodeSource), npm's global prefix points at a root-owned location. Then `npm install -g ...` fails with `EACCES` / `mkdir` permission errors.
|
|
69
69
|
|
|
70
70
|
`install.sh` mitigates this by switching the prefix to:
|
|
71
71
|
|
package/docs/start/hubs.md
CHANGED
|
@@ -156,7 +156,7 @@ Use these hubs to discover every page, including deep dives and reference docs t
|
|
|
156
156
|
## Workspace + templates
|
|
157
157
|
|
|
158
158
|
- [Skills](/tools/skills)
|
|
159
|
-
- [
|
|
159
|
+
- [ClawHub](/tools/clawhub)
|
|
160
160
|
- [Skills config](/tools/skills-config)
|
|
161
161
|
- [Default AGENTS](/reference/AGENTS.default)
|
|
162
162
|
- [Templates: AGENTS](/reference/templates/AGENTS)
|
package/docs/start/lore.md
CHANGED
|
@@ -13,7 +13,7 @@ In the beginning, there was **Warelay** — a sensible name for a WhatsApp gatew
|
|
|
13
13
|
|
|
14
14
|
But then came a space lobster.
|
|
15
15
|
|
|
16
|
-
For a while, the lobster was called **Clawd**, living in
|
|
16
|
+
For a while, the lobster was called **Clawd**, living in an **OpenClaw**. But in January 2026, Anthropic sent a polite email asking for a name change (trademark stuff). And so the lobster did what lobsters do best:
|
|
17
17
|
|
|
18
18
|
**It molted.**
|
|
19
19
|
|
package/docs/start/showcase.md
CHANGED
|
@@ -134,28 +134,28 @@ Full setup walkthrough (28m) by VelvetShark.
|
|
|
134
134
|
<img src="/assets/showcase/papla-tts.jpg" alt="Telegram voice note output from TTS" />
|
|
135
135
|
</Card>
|
|
136
136
|
|
|
137
|
-
<Card title="CodexMonitor" icon="eye" href="https://
|
|
137
|
+
<Card title="CodexMonitor" icon="eye" href="https://clawhub.com/odrobnik/codexmonitor">
|
|
138
138
|
**@odrobnik** • `devtools` `codex` `brew`
|
|
139
139
|
|
|
140
140
|
Homebrew-installed helper to list/inspect/watch local OpenAI Codex sessions (CLI + VS Code).
|
|
141
141
|
|
|
142
|
-
<img src="/assets/showcase/codexmonitor.png" alt="CodexMonitor on
|
|
142
|
+
<img src="/assets/showcase/codexmonitor.png" alt="CodexMonitor on ClawHub" />
|
|
143
143
|
</Card>
|
|
144
144
|
|
|
145
|
-
<Card title="Bambu 3D Printer Control" icon="print" href="https://
|
|
145
|
+
<Card title="Bambu 3D Printer Control" icon="print" href="https://clawhub.com/tobiasbischoff/bambu-cli">
|
|
146
146
|
**@tobiasbischoff** • `hardware` `3d-printing` `skill`
|
|
147
147
|
|
|
148
148
|
Control and troubleshoot BambuLab printers: status, jobs, camera, AMS, calibration, and more.
|
|
149
149
|
|
|
150
|
-
<img src="/assets/showcase/bambu-cli.png" alt="Bambu CLI skill on
|
|
150
|
+
<img src="/assets/showcase/bambu-cli.png" alt="Bambu CLI skill on ClawHub" />
|
|
151
151
|
</Card>
|
|
152
152
|
|
|
153
|
-
<Card title="Vienna Transport (Wiener Linien)" icon="train" href="https://
|
|
153
|
+
<Card title="Vienna Transport (Wiener Linien)" icon="train" href="https://clawhub.com/hjanuschka/wienerlinien">
|
|
154
154
|
**@hjanuschka** • `travel` `transport` `skill`
|
|
155
155
|
|
|
156
156
|
Real-time departures, disruptions, elevator status, and routing for Vienna's public transport.
|
|
157
157
|
|
|
158
|
-
<img src="/assets/showcase/wienerlinien.png" alt="Wiener Linien skill on
|
|
158
|
+
<img src="/assets/showcase/wienerlinien.png" alt="Wiener Linien skill on ClawHub" />
|
|
159
159
|
</Card>
|
|
160
160
|
|
|
161
161
|
<Card title="ParentPay School Meals" icon="utensils" href="#">
|
|
@@ -164,7 +164,7 @@ Full setup walkthrough (28m) by VelvetShark.
|
|
|
164
164
|
Automated UK school meal booking via ParentPay. Uses mouse coordinates for reliable table cell clicking.
|
|
165
165
|
</Card>
|
|
166
166
|
|
|
167
|
-
<Card title="R2 Upload (Send Me My Files)" icon="cloud-arrow-up" href="https://
|
|
167
|
+
<Card title="R2 Upload (Send Me My Files)" icon="cloud-arrow-up" href="https://clawhub.com/skills/r2-upload">
|
|
168
168
|
**@julianengel** • `files` `r2` `presigned-urls`
|
|
169
169
|
|
|
170
170
|
Upload to Cloudflare R2/S3 and generate secure presigned download links. Perfect for remote OpenClaw instances.
|
|
@@ -260,7 +260,7 @@ Full setup walkthrough (28m) by VelvetShark.
|
|
|
260
260
|
<Card title="Jira Skill Builder" icon="diagram-project" href="https://x.com/jdrhyne/status/2008336434827002232">
|
|
261
261
|
**@jdrhyne** • `automation` `jira` `skill` `devtools`
|
|
262
262
|
|
|
263
|
-
OpenClaw connected to Jira, then generated a new skill on the fly (before it existed on
|
|
263
|
+
OpenClaw connected to Jira, then generated a new skill on the fly (before it existed on ClawHub).
|
|
264
264
|
</Card>
|
|
265
265
|
|
|
266
266
|
<Card title="Todoist Skill via Telegram" icon="list-check" href="https://x.com/iamsubhrajyoti/status/2009949389884920153">
|
|
@@ -325,10 +325,10 @@ Full setup walkthrough (28m) by VelvetShark.
|
|
|
325
325
|
Vapi voice assistant ↔ OpenClaw HTTP bridge. Near real-time phone calls with your agent.
|
|
326
326
|
</Card>
|
|
327
327
|
|
|
328
|
-
<Card title="OpenRouter Transcription" icon="microphone" href="https://
|
|
328
|
+
<Card title="OpenRouter Transcription" icon="microphone" href="https://clawhub.com/obviyus/openrouter-transcribe">
|
|
329
329
|
**@obviyus** • `transcription` `multilingual` `skill`
|
|
330
330
|
|
|
331
|
-
Multi-lingual audio transcription via OpenRouter (Gemini, etc). Available on
|
|
331
|
+
Multi-lingual audio transcription via OpenRouter (Gemini, etc). Available on ClawHub.
|
|
332
332
|
</Card>
|
|
333
333
|
|
|
334
334
|
</CardGroup>
|
|
@@ -343,8 +343,8 @@ Full setup walkthrough (28m) by VelvetShark.
|
|
|
343
343
|
OpenClaw gateway running on Home Assistant OS with SSH tunnel support and persistent state.
|
|
344
344
|
</Card>
|
|
345
345
|
|
|
346
|
-
<Card title="Home Assistant Skill" icon="toggle-on" href="https://
|
|
347
|
-
**
|
|
346
|
+
<Card title="Home Assistant Skill" icon="toggle-on" href="https://clawhub.com/skills/homeassistant">
|
|
347
|
+
**ClawHub** • `homeassistant` `skill` `automation`
|
|
348
348
|
|
|
349
349
|
Control and automate Home Assistant devices via natural language.
|
|
350
350
|
</Card>
|
|
@@ -355,8 +355,8 @@ Full setup walkthrough (28m) by VelvetShark.
|
|
|
355
355
|
Batteries-included nixified OpenClaw configuration for reproducible deployments.
|
|
356
356
|
</Card>
|
|
357
357
|
|
|
358
|
-
<Card title="CalDAV Calendar" icon="calendar" href="https://
|
|
359
|
-
**
|
|
358
|
+
<Card title="CalDAV Calendar" icon="calendar" href="https://clawhub.com/skills/caldav-calendar">
|
|
359
|
+
**ClawHub** • `calendar` `caldav` `skill`
|
|
360
360
|
|
|
361
361
|
Calendar skill using khal/vdirsyncer. Self-hosted calendar integration.
|
|
362
362
|
</Card>
|
package/docs/start/wizard.md
CHANGED
|
@@ -117,14 +117,14 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
|
|
|
117
117
|
- Non‑loopback binds still require auth.
|
|
118
118
|
|
|
119
119
|
5) **Channels**
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
- Signal: optional `signal-cli` install + account config.
|
|
126
|
-
- iMessage: local `imsg` CLI path + DB access.
|
|
127
|
-
|
|
120
|
+
- [WhatsApp](/channels/whatsapp): optional QR login.
|
|
121
|
+
- [Telegram](/channels/telegram): bot token.
|
|
122
|
+
- [Discord](/channels/discord): bot token.
|
|
123
|
+
- [Google Chat](/channels/googlechat): service account JSON + webhook audience.
|
|
124
|
+
- [Mattermost](/channels/mattermost) (plugin): bot token + base URL.
|
|
125
|
+
- [Signal](/channels/signal): optional `signal-cli` install + account config.
|
|
126
|
+
- [iMessage](/channels/imessage): local `imsg` CLI path + DB access.
|
|
127
|
+
- DM security: default is pairing. First DM sends a code; approve via `openclaw pairing approve <channel> <code>` or use allowlists.
|
|
128
128
|
|
|
129
129
|
6) **Daemon install**
|
|
130
130
|
- macOS: LaunchAgent
|
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
---
|
|
2
|
-
summary: "
|
|
2
|
+
summary: "ClawHub guide: public skills registry + CLI workflows"
|
|
3
3
|
read_when:
|
|
4
|
-
- Introducing
|
|
4
|
+
- Introducing ClawHub to new users
|
|
5
5
|
- Installing, searching, or publishing skills
|
|
6
|
-
- Explaining
|
|
6
|
+
- Explaining ClawHub CLI flags and sync behavior
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
#
|
|
9
|
+
# ClawHub
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
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
12
|
|
|
13
|
-
Site: [
|
|
13
|
+
Site: [clawhub.com](https://clawhub.com)
|
|
14
14
|
|
|
15
15
|
## Who this is for (beginner-friendly)
|
|
16
16
|
|
|
17
|
-
If you want to add new capabilities to your OpenClaw agent,
|
|
17
|
+
If you want to add new capabilities to your OpenClaw agent, ClawHub is the easiest way to find and install skills. You do not need to know how the backend works. You can:
|
|
18
18
|
|
|
19
19
|
- Search for skills by plain language.
|
|
20
20
|
- Install a skill into your workspace.
|
|
@@ -25,9 +25,9 @@ If you want to add new capabilities to your OpenClaw agent, ClawdHub is the easi
|
|
|
25
25
|
|
|
26
26
|
1) Install the CLI (see next section).
|
|
27
27
|
2) Search for something you need:
|
|
28
|
-
- `
|
|
28
|
+
- `clawhub search "calendar"`
|
|
29
29
|
3) Install a skill:
|
|
30
|
-
- `
|
|
30
|
+
- `clawhub install <skill-slug>`
|
|
31
31
|
4) Start a new OpenClaw session so it picks up the new skill.
|
|
32
32
|
|
|
33
33
|
## Install the CLI
|
|
@@ -35,16 +35,16 @@ If you want to add new capabilities to your OpenClaw agent, ClawdHub is the easi
|
|
|
35
35
|
Pick one:
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
|
-
npm i -g
|
|
38
|
+
npm i -g clawhub
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
pnpm add -g
|
|
42
|
+
pnpm add -g clawhub
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
## How it fits into OpenClaw
|
|
46
46
|
|
|
47
|
-
By default, the CLI installs skills into `./skills` under your current working directory. If a OpenClaw workspace is configured, `
|
|
47
|
+
By default, the CLI installs skills into `./skills` under your current working directory. If a 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.
|
|
48
48
|
|
|
49
49
|
For more detail on how skills are loaded, shared, and gated, see
|
|
50
50
|
[Skills](/tools/skills).
|
|
@@ -72,9 +72,9 @@ Global options (apply to all commands):
|
|
|
72
72
|
|
|
73
73
|
Auth:
|
|
74
74
|
|
|
75
|
-
- `
|
|
76
|
-
- `
|
|
77
|
-
- `
|
|
75
|
+
- `clawhub login` (browser flow) or `clawhub login --token <token>`
|
|
76
|
+
- `clawhub logout`
|
|
77
|
+
- `clawhub whoami`
|
|
78
78
|
|
|
79
79
|
Options:
|
|
80
80
|
|
|
@@ -84,29 +84,29 @@ Options:
|
|
|
84
84
|
|
|
85
85
|
Search:
|
|
86
86
|
|
|
87
|
-
- `
|
|
87
|
+
- `clawhub search "query"`
|
|
88
88
|
- `--limit <n>`: Max results.
|
|
89
89
|
|
|
90
90
|
Install:
|
|
91
91
|
|
|
92
|
-
- `
|
|
92
|
+
- `clawhub install <slug>`
|
|
93
93
|
- `--version <version>`: Install a specific version.
|
|
94
94
|
- `--force`: Overwrite if the folder already exists.
|
|
95
95
|
|
|
96
96
|
Update:
|
|
97
97
|
|
|
98
|
-
- `
|
|
99
|
-
- `
|
|
98
|
+
- `clawhub update <slug>`
|
|
99
|
+
- `clawhub update --all`
|
|
100
100
|
- `--version <version>`: Update to a specific version (single slug only).
|
|
101
101
|
- `--force`: Overwrite when local files do not match any published version.
|
|
102
102
|
|
|
103
103
|
List:
|
|
104
104
|
|
|
105
|
-
- `
|
|
105
|
+
- `clawhub list` (reads `.clawhub/lock.json`)
|
|
106
106
|
|
|
107
107
|
Publish:
|
|
108
108
|
|
|
109
|
-
- `
|
|
109
|
+
- `clawhub publish <path>`
|
|
110
110
|
- `--slug <slug>`: Skill slug.
|
|
111
111
|
- `--name <name>`: Display name.
|
|
112
112
|
- `--version <version>`: Semver version.
|
|
@@ -115,12 +115,12 @@ Publish:
|
|
|
115
115
|
|
|
116
116
|
Delete/undelete (owner/admin only):
|
|
117
117
|
|
|
118
|
-
- `
|
|
119
|
-
- `
|
|
118
|
+
- `clawhub delete <slug> --yes`
|
|
119
|
+
- `clawhub undelete <slug> --yes`
|
|
120
120
|
|
|
121
121
|
Sync (scan local skills + publish new/updated):
|
|
122
122
|
|
|
123
|
-
- `
|
|
123
|
+
- `clawhub sync`
|
|
124
124
|
- `--root <dir...>`: Extra scan roots.
|
|
125
125
|
- `--all`: Upload everything without prompts.
|
|
126
126
|
- `--dry-run`: Show what would be uploaded.
|
|
@@ -134,19 +134,19 @@ Sync (scan local skills + publish new/updated):
|
|
|
134
134
|
### Search for skills
|
|
135
135
|
|
|
136
136
|
```bash
|
|
137
|
-
|
|
137
|
+
clawhub search "postgres backups"
|
|
138
138
|
```
|
|
139
139
|
|
|
140
140
|
### Download new skills
|
|
141
141
|
|
|
142
142
|
```bash
|
|
143
|
-
|
|
143
|
+
clawhub install my-skill-pack
|
|
144
144
|
```
|
|
145
145
|
|
|
146
146
|
### Update installed skills
|
|
147
147
|
|
|
148
148
|
```bash
|
|
149
|
-
|
|
149
|
+
clawhub update --all
|
|
150
150
|
```
|
|
151
151
|
|
|
152
152
|
### Back up your skills (publish or sync)
|
|
@@ -154,13 +154,13 @@ clawdhub update --all
|
|
|
154
154
|
For a single skill folder:
|
|
155
155
|
|
|
156
156
|
```bash
|
|
157
|
-
|
|
157
|
+
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
|
|
158
158
|
```
|
|
159
159
|
|
|
160
160
|
To scan and back up many skills at once:
|
|
161
161
|
|
|
162
162
|
```bash
|
|
163
|
-
|
|
163
|
+
clawhub sync --all
|
|
164
164
|
```
|
|
165
165
|
|
|
166
166
|
## Advanced details (technical)
|
|
@@ -177,25 +177,25 @@ Updates compare the local skill contents to registry versions using a content ha
|
|
|
177
177
|
|
|
178
178
|
### Sync scanning and fallback roots
|
|
179
179
|
|
|
180
|
-
`
|
|
180
|
+
`clawhub sync` scans your current workdir first. If no skills are found, it falls back to known legacy locations (for example `~/openclaw/skills` and `~/.openclaw/skills`). This is designed to find older skill installs without extra flags.
|
|
181
181
|
|
|
182
182
|
### Storage and lockfile
|
|
183
183
|
|
|
184
|
-
- Installed skills are recorded in `.
|
|
185
|
-
- Auth tokens are stored in the
|
|
184
|
+
- Installed skills are recorded in `.clawhub/lock.json` under your workdir.
|
|
185
|
+
- Auth tokens are stored in the ClawHub CLI config file (override via `CLAWHUB_CONFIG_PATH`).
|
|
186
186
|
|
|
187
187
|
### Telemetry (install counts)
|
|
188
188
|
|
|
189
|
-
When you run `
|
|
189
|
+
When you run `clawhub sync` while logged in, the CLI sends a minimal snapshot to compute install counts. You can disable this entirely:
|
|
190
190
|
|
|
191
191
|
```bash
|
|
192
|
-
export
|
|
192
|
+
export CLAWHUB_DISABLE_TELEMETRY=1
|
|
193
193
|
```
|
|
194
194
|
|
|
195
195
|
## Environment variables
|
|
196
196
|
|
|
197
|
-
- `
|
|
198
|
-
- `
|
|
199
|
-
- `
|
|
200
|
-
- `
|
|
201
|
-
- `
|
|
197
|
+
- `CLAWHUB_SITE`: Override the site URL.
|
|
198
|
+
- `CLAWHUB_REGISTRY`: Override the registry API URL.
|
|
199
|
+
- `CLAWHUB_CONFIG_PATH`: Override where the CLI stores the token/config.
|
|
200
|
+
- `CLAWHUB_WORKDIR`: Override the default workdir.
|
|
201
|
+
- `CLAWHUB_DISABLE_TELEMETRY=1`: Disable telemetry on `sync`.
|
|
@@ -38,4 +38,4 @@ Ask your agent to "refresh skills" or restart the gateway. OpenClaw will discove
|
|
|
38
38
|
- **Test Locally**: Use `openclaw agent --message "use my new skill"` to test.
|
|
39
39
|
|
|
40
40
|
## Shared Skills
|
|
41
|
-
You can also browse and contribute skills to [
|
|
41
|
+
You can also browse and contribute skills to [ClawHub](https://clawhub.com).
|
package/docs/tools/skills.md
CHANGED
|
@@ -45,22 +45,22 @@ You can gate them via `metadata.openclaw.requires.config` on the plugin’s conf
|
|
|
45
45
|
entry. See [Plugins](/plugin) for discovery/config and [Tools](/tools) for the
|
|
46
46
|
tool surface those skills teach.
|
|
47
47
|
|
|
48
|
-
##
|
|
48
|
+
## ClawHub (install + sync)
|
|
49
49
|
|
|
50
|
-
|
|
51
|
-
https://
|
|
52
|
-
Full guide: [
|
|
50
|
+
ClawHub is the public skills registry for OpenClaw. Browse at
|
|
51
|
+
https://clawhub.com. Use it to discover, install, update, and back up skills.
|
|
52
|
+
Full guide: [ClawHub](/tools/clawhub).
|
|
53
53
|
|
|
54
54
|
Common flows:
|
|
55
55
|
|
|
56
56
|
- Install a skill into your workspace:
|
|
57
|
-
- `
|
|
57
|
+
- `clawhub install <skill-slug>`
|
|
58
58
|
- Update all installed skills:
|
|
59
|
-
- `
|
|
59
|
+
- `clawhub update --all`
|
|
60
60
|
- Sync (scan + publish updates):
|
|
61
|
-
- `
|
|
61
|
+
- `clawhub sync --all`
|
|
62
62
|
|
|
63
|
-
By default, `
|
|
63
|
+
By default, `clawhub` installs into `./skills` under your current working
|
|
64
64
|
directory (or falls back to the configured OpenClaw workspace). OpenClaw picks
|
|
65
65
|
that up as `<workspace>/skills` on the next session.
|
|
66
66
|
|
|
@@ -262,6 +262,6 @@ See [Skills config](/tools/skills-config) for the full configuration schema.
|
|
|
262
262
|
|
|
263
263
|
## Looking for more skills?
|
|
264
264
|
|
|
265
|
-
Browse https://
|
|
265
|
+
Browse https://clawhub.com.
|
|
266
266
|
|
|
267
267
|
---
|
package/package.json
CHANGED
|
@@ -31,7 +31,7 @@ The shell tool uses a fresh TTY per command. To avoid re-prompts and failures, a
|
|
|
31
31
|
Example (see `tmux` skill for socket conventions, do not reuse old session names):
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
|
-
SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}"
|
|
34
|
+
SOCKET_DIR="${OPENCLAW_TMUX_SOCKET_DIR:-${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}}"
|
|
35
35
|
mkdir -p "$SOCKET_DIR"
|
|
36
36
|
SOCKET="$SOCKET_DIR/openclaw-op.sock"
|
|
37
37
|
SESSION="op-auth-$(date +%Y%m%d-%H%M%S)"
|