@qingchencloud/openclaw-zh 2026.1.29-nightly.202601301919 → 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
|
@@ -28,7 +28,7 @@ Use this skill when working on the BlueBubbles channel plugin.
|
|
|
28
28
|
- BlueBubbles posts JSON to the gateway HTTP server.
|
|
29
29
|
- Normalize sender/chat IDs defensively (payloads vary by version).
|
|
30
30
|
- Skip messages marked as from self.
|
|
31
|
-
- Route into core reply pipeline via the plugin runtime (`api.runtime`) and `
|
|
31
|
+
- Route into core reply pipeline via the plugin runtime (`api.runtime`) and `openclaw/plugin-sdk` helpers.
|
|
32
32
|
- For attachments/stickers, use `<media:...>` placeholders when text is empty and attach media paths via `MediaUrl(s)` in the inbound context.
|
|
33
33
|
|
|
34
34
|
## Config (core)
|
package/skills/canvas/SKILL.md
CHANGED
|
@@ -55,7 +55,7 @@ This is why localhost URLs don't work - the node receives the Tailscale hostname
|
|
|
55
55
|
|
|
56
56
|
## Configuration
|
|
57
57
|
|
|
58
|
-
In `~/.
|
|
58
|
+
In `~/.openclaw/openclaw.json`:
|
|
59
59
|
|
|
60
60
|
```json
|
|
61
61
|
{
|
|
@@ -102,7 +102,7 @@ HTML
|
|
|
102
102
|
|
|
103
103
|
Check how your gateway is bound:
|
|
104
104
|
```bash
|
|
105
|
-
cat ~/.
|
|
105
|
+
cat ~/.openclaw/openclaw.json | jq '.gateway.bind'
|
|
106
106
|
```
|
|
107
107
|
|
|
108
108
|
Then construct the URL:
|
|
@@ -148,7 +148,7 @@ canvas action:hide node:<node-id>
|
|
|
148
148
|
**Cause:** URL mismatch between server bind and node expectation.
|
|
149
149
|
|
|
150
150
|
**Debug steps:**
|
|
151
|
-
1. Check server bind: `cat ~/.
|
|
151
|
+
1. Check server bind: `cat ~/.openclaw/openclaw.json | jq '.gateway.bind'`
|
|
152
152
|
2. Check what port canvas is on: `lsof -i :18793`
|
|
153
153
|
3. Test URL directly: `curl http://<hostname>:18793/__moltbot__/canvas/<file>.html`
|
|
154
154
|
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: clawhub
|
|
3
|
+
description: Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawhub CLI.
|
|
4
|
+
metadata: {"openclaw":{"requires":{"bins":["clawhub"]},"install":[{"id":"node","kind":"node","package":"clawhub","bins":["clawhub"],"label":"Install ClawHub CLI (npm)"}]}}
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# ClawHub CLI
|
|
8
|
+
|
|
9
|
+
Install
|
|
10
|
+
```bash
|
|
11
|
+
npm i -g clawhub
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Auth (publish)
|
|
15
|
+
```bash
|
|
16
|
+
clawhub login
|
|
17
|
+
clawhub whoami
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Search
|
|
21
|
+
```bash
|
|
22
|
+
clawhub search "postgres backups"
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
Install
|
|
26
|
+
```bash
|
|
27
|
+
clawhub install my-skill
|
|
28
|
+
clawhub install my-skill --version 1.2.3
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Update (hash-based match + upgrade)
|
|
32
|
+
```bash
|
|
33
|
+
clawhub update my-skill
|
|
34
|
+
clawhub update my-skill --version 1.2.3
|
|
35
|
+
clawhub update --all
|
|
36
|
+
clawhub update my-skill --force
|
|
37
|
+
clawhub update --all --no-input --force
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
List
|
|
41
|
+
```bash
|
|
42
|
+
clawhub list
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Publish
|
|
46
|
+
```bash
|
|
47
|
+
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Notes
|
|
51
|
+
- Default registry: https://clawhub.com (override with CLAWHUB_REGISTRY or --registry)
|
|
52
|
+
- Default workdir: cwd (falls back to OpenClaw workspace); install dir: ./skills (override with --workdir / --dir / CLAWHUB_WORKDIR)
|
|
53
|
+
- Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set
|
|
@@ -26,7 +26,7 @@ uv run {baseDir}/scripts/generate_image.py --prompt "combine these into one scen
|
|
|
26
26
|
|
|
27
27
|
API key
|
|
28
28
|
- `GEMINI_API_KEY` env var
|
|
29
|
-
- Or set `skills."nano-banana-pro".apiKey` / `skills."nano-banana-pro".env.GEMINI_API_KEY` in `~/.
|
|
29
|
+
- Or set `skills."nano-banana-pro".apiKey` / `skills."nano-banana-pro".env.GEMINI_API_KEY` in `~/.openclaw/openclaw.json`
|
|
30
30
|
|
|
31
31
|
Notes
|
|
32
32
|
- Resolutions: `1K` (default), `2K`, `4K`.
|
|
@@ -14,7 +14,7 @@ Use this skill when the user asks about prior chats, parent conversations, or hi
|
|
|
14
14
|
|
|
15
15
|
## Location
|
|
16
16
|
|
|
17
|
-
Session logs live at: `~/.
|
|
17
|
+
Session logs live at: `~/.openclaw/agents/<agentId>/sessions/` (use the `agent=<id>` value from the system prompt Runtime line).
|
|
18
18
|
|
|
19
19
|
- **`sessions.json`** - Index mapping session keys to session IDs
|
|
20
20
|
- **`<session-id>.jsonl`** - Full conversation transcript per session
|
|
@@ -32,7 +32,7 @@ Each `.jsonl` file contains messages with:
|
|
|
32
32
|
|
|
33
33
|
### List all sessions by date and size
|
|
34
34
|
```bash
|
|
35
|
-
for f in ~/.
|
|
35
|
+
for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
|
|
36
36
|
date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
|
|
37
37
|
size=$(ls -lh "$f" | awk '{print $5}')
|
|
38
38
|
echo "$date $size $(basename $f)"
|
|
@@ -41,7 +41,7 @@ done | sort -r
|
|
|
41
41
|
|
|
42
42
|
### Find sessions from a specific day
|
|
43
43
|
```bash
|
|
44
|
-
for f in ~/.
|
|
44
|
+
for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
|
|
45
45
|
head -1 "$f" | jq -r '.timestamp' | grep -q "2026-01-06" && echo "$f"
|
|
46
46
|
done
|
|
47
47
|
```
|
|
@@ -63,7 +63,7 @@ jq -s '[.[] | .message.usage.cost.total // 0] | add' <session>.jsonl
|
|
|
63
63
|
|
|
64
64
|
### Daily cost summary
|
|
65
65
|
```bash
|
|
66
|
-
for f in ~/.
|
|
66
|
+
for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
|
|
67
67
|
date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
|
|
68
68
|
cost=$(jq -s '[.[] | .message.usage.cost.total // 0] | add' "$f")
|
|
69
69
|
echo "$date $cost"
|
|
@@ -88,7 +88,7 @@ jq -r '.message.content[]? | select(.type == "toolCall") | .name' <session>.json
|
|
|
88
88
|
|
|
89
89
|
### Search across ALL sessions for a phrase
|
|
90
90
|
```bash
|
|
91
|
-
rg -l "phrase" ~/.
|
|
91
|
+
rg -l "phrase" ~/.openclaw/agents/<agentId>/sessions/*.jsonl
|
|
92
92
|
```
|
|
93
93
|
|
|
94
94
|
## Tips
|
|
@@ -101,5 +101,5 @@ rg -l "phrase" ~/.clawdbot/agents/<agentId>/sessions/*.jsonl
|
|
|
101
101
|
## Fast text-only hint (low noise)
|
|
102
102
|
|
|
103
103
|
```bash
|
|
104
|
-
jq -r 'select(.type=="message") | .message.content[]? | select(.type=="text") | .text' ~/.
|
|
104
|
+
jq -r 'select(.type=="message") | .message.content[]? | select(.type=="text") | .text' ~/.openclaw/agents/<agentId>/sessions/<id>.jsonl | rg 'keyword'
|
|
105
105
|
```
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sherpa-onnx-tts
|
|
3
3
|
description: Local text-to-speech via sherpa-onnx (offline, no cloud)
|
|
4
|
-
metadata: {"openclaw":{"emoji":"🗣️","os":["darwin","linux","win32"],"requires":{"env":["SHERPA_ONNX_RUNTIME_DIR","SHERPA_ONNX_MODEL_DIR"]},"install":[{"id":"download-runtime-macos","kind":"download","os":["darwin"],"url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-osx-universal2-shared.tar.bz2","archive":"tar.bz2","extract":true,"stripComponents":1,"targetDir":"~/.
|
|
4
|
+
metadata: {"openclaw":{"emoji":"🗣️","os":["darwin","linux","win32"],"requires":{"env":["SHERPA_ONNX_RUNTIME_DIR","SHERPA_ONNX_MODEL_DIR"]},"install":[{"id":"download-runtime-macos","kind":"download","os":["darwin"],"url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-osx-universal2-shared.tar.bz2","archive":"tar.bz2","extract":true,"stripComponents":1,"targetDir":"~/.openclaw/tools/sherpa-onnx-tts/runtime","label":"Download sherpa-onnx runtime (macOS)"},{"id":"download-runtime-linux-x64","kind":"download","os":["linux"],"url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-linux-x64-shared.tar.bz2","archive":"tar.bz2","extract":true,"stripComponents":1,"targetDir":"~/.openclaw/tools/sherpa-onnx-tts/runtime","label":"Download sherpa-onnx runtime (Linux x64)"},{"id":"download-runtime-win-x64","kind":"download","os":["win32"],"url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-win-x64-shared.tar.bz2","archive":"tar.bz2","extract":true,"stripComponents":1,"targetDir":"~/.openclaw/tools/sherpa-onnx-tts/runtime","label":"Download sherpa-onnx runtime (Windows x64)"},{"id":"download-model-lessac","kind":"download","url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-en_US-lessac-high.tar.bz2","archive":"tar.bz2","extract":true,"targetDir":"~/.openclaw/tools/sherpa-onnx-tts/models","label":"Download Piper en_US lessac (high)"}]}}
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# sherpa-onnx-tts
|
|
@@ -10,10 +10,10 @@ Local TTS using the sherpa-onnx offline CLI.
|
|
|
10
10
|
|
|
11
11
|
## Install
|
|
12
12
|
|
|
13
|
-
1) Download the runtime for your OS (extracts into `~/.
|
|
14
|
-
2) Download a voice model (extracts into `~/.
|
|
13
|
+
1) Download the runtime for your OS (extracts into `~/.openclaw/tools/sherpa-onnx-tts/runtime`)
|
|
14
|
+
2) Download a voice model (extracts into `~/.openclaw/tools/sherpa-onnx-tts/models`)
|
|
15
15
|
|
|
16
|
-
Update `~/.
|
|
16
|
+
Update `~/.openclaw/openclaw.json`:
|
|
17
17
|
|
|
18
18
|
```json5
|
|
19
19
|
{
|
|
@@ -21,8 +21,8 @@ Update `~/.clawdbot/openclaw.json`:
|
|
|
21
21
|
entries: {
|
|
22
22
|
"sherpa-onnx-tts": {
|
|
23
23
|
env: {
|
|
24
|
-
SHERPA_ONNX_RUNTIME_DIR: "~/.
|
|
25
|
-
SHERPA_ONNX_MODEL_DIR: "~/.
|
|
24
|
+
SHERPA_ONNX_RUNTIME_DIR: "~/.openclaw/tools/sherpa-onnx-tts/runtime",
|
|
25
|
+
SHERPA_ONNX_MODEL_DIR: "~/.openclaw/tools/sherpa-onnx-tts/models/vits-piper-en_US-lessac-high"
|
|
26
26
|
}
|
|
27
27
|
}
|
|
28
28
|
}
|
package/skills/tmux/SKILL.md
CHANGED
|
@@ -11,7 +11,7 @@ Use tmux only when you need an interactive TTY. Prefer exec background mode for
|
|
|
11
11
|
## Quickstart (isolated socket, exec tool)
|
|
12
12
|
|
|
13
13
|
```bash
|
|
14
|
-
SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}"
|
|
14
|
+
SOCKET_DIR="${OPENCLAW_TMUX_SOCKET_DIR:-${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}}"
|
|
15
15
|
mkdir -p "$SOCKET_DIR"
|
|
16
16
|
SOCKET="$SOCKET_DIR/openclaw.sock"
|
|
17
17
|
SESSION=openclaw-python
|
|
@@ -31,8 +31,8 @@ To monitor:
|
|
|
31
31
|
|
|
32
32
|
## Socket convention
|
|
33
33
|
|
|
34
|
-
- Use `
|
|
35
|
-
- Default socket path: `"$
|
|
34
|
+
- Use `OPENCLAW_TMUX_SOCKET_DIR` (legacy `CLAWDBOT_TMUX_SOCKET_DIR` also supported).
|
|
35
|
+
- Default socket path: `"$OPENCLAW_TMUX_SOCKET_DIR/openclaw.sock"`.
|
|
36
36
|
|
|
37
37
|
## Targeting panes and naming
|
|
38
38
|
|
|
@@ -43,7 +43,7 @@ To monitor:
|
|
|
43
43
|
## Finding sessions
|
|
44
44
|
|
|
45
45
|
- List sessions on your socket: `{baseDir}/scripts/find-sessions.sh -S "$SOCKET"`.
|
|
46
|
-
- Scan all sockets: `{baseDir}/scripts/find-sessions.sh --all` (uses `
|
|
46
|
+
- Scan all sockets: `{baseDir}/scripts/find-sessions.sh --all` (uses `OPENCLAW_TMUX_SOCKET_DIR`).
|
|
47
47
|
|
|
48
48
|
## Sending input safely
|
|
49
49
|
|
|
@@ -10,7 +10,7 @@ List tmux sessions on a socket (default tmux socket if none provided).
|
|
|
10
10
|
Options:
|
|
11
11
|
-L, --socket tmux socket name (passed to tmux -L)
|
|
12
12
|
-S, --socket-path tmux socket path (passed to tmux -S)
|
|
13
|
-
-A, --all scan all sockets under
|
|
13
|
+
-A, --all scan all sockets under OPENCLAW_TMUX_SOCKET_DIR
|
|
14
14
|
-q, --query case-insensitive substring to filter session names
|
|
15
15
|
-h, --help show this help
|
|
16
16
|
USAGE
|
|
@@ -20,7 +20,7 @@ socket_name=""
|
|
|
20
20
|
socket_path=""
|
|
21
21
|
query=""
|
|
22
22
|
scan_all=false
|
|
23
|
-
socket_dir="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/
|
|
23
|
+
socket_dir="${OPENCLAW_TMUX_SOCKET_DIR:-${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/openclaw-tmux-sockets}}"
|
|
24
24
|
|
|
25
25
|
while [[ $# -gt 0 ]]; do
|
|
26
26
|
case "$1" in
|
package/skills/clawdhub/SKILL.md
DELETED
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: clawdhub
|
|
3
|
-
description: Use the ClawdHub CLI to search, install, update, and publish agent skills from clawdhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawdhub CLI.
|
|
4
|
-
metadata: {"openclaw":{"requires":{"bins":["clawdhub"]},"install":[{"id":"node","kind":"node","package":"clawdhub","bins":["clawdhub"],"label":"Install ClawdHub CLI (npm)"}]}}
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# ClawdHub CLI
|
|
8
|
-
|
|
9
|
-
Install
|
|
10
|
-
```bash
|
|
11
|
-
npm i -g clawdhub
|
|
12
|
-
```
|
|
13
|
-
|
|
14
|
-
Auth (publish)
|
|
15
|
-
```bash
|
|
16
|
-
clawdhub login
|
|
17
|
-
clawdhub whoami
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
Search
|
|
21
|
-
```bash
|
|
22
|
-
clawdhub search "postgres backups"
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
Install
|
|
26
|
-
```bash
|
|
27
|
-
clawdhub install my-skill
|
|
28
|
-
clawdhub install my-skill --version 1.2.3
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
Update (hash-based match + upgrade)
|
|
32
|
-
```bash
|
|
33
|
-
clawdhub update my-skill
|
|
34
|
-
clawdhub update my-skill --version 1.2.3
|
|
35
|
-
clawdhub update --all
|
|
36
|
-
clawdhub update my-skill --force
|
|
37
|
-
clawdhub update --all --no-input --force
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
List
|
|
41
|
-
```bash
|
|
42
|
-
clawdhub list
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
Publish
|
|
46
|
-
```bash
|
|
47
|
-
clawdhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
Notes
|
|
51
|
-
- Default registry: https://clawdhub.com (override with CLAWDHUB_REGISTRY or --registry)
|
|
52
|
-
- Default workdir: cwd (falls back to OpenClaw workspace); install dir: ./skills (override with --workdir / --dir / CLAWDHUB_WORKDIR)
|
|
53
|
-
- Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set
|