@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.
Files changed (42) hide show
  1. package/CHANGELOG.md +10 -9
  2. package/README.md +86 -20
  3. package/dist/agents/system-prompt.js +1 -1
  4. package/dist/build-info.json +3 -3
  5. package/dist/canvas-host/a2ui/.bundle.hash +1 -1
  6. package/dist/cli/cli-utils.js +10 -0
  7. package/dist/cli/models-cli.js +20 -8
  8. package/dist/cli/skills-cli.js +7 -7
  9. package/dist/commands/models/auth-order.js +2 -2
  10. package/dist/commands/models/list.status-command.js +37 -17
  11. package/dist/commands/models/shared.js +14 -0
  12. package/dist/control-ui/assets/{index-CNKLKKXX.js → index-Bpe27rQF.js} +2 -2
  13. package/dist/control-ui/assets/{index-CNKLKKXX.js.map → index-Bpe27rQF.js.map} +1 -1
  14. package/dist/control-ui/index.html +1 -1
  15. package/docs/cli/index.md +1 -1
  16. package/docs/cli/models.md +4 -0
  17. package/docs/cli/skills.md +1 -2
  18. package/docs/concepts/agent.md +2 -2
  19. package/docs/concepts/system-prompt.md +1 -1
  20. package/docs/docs.json +10 -2
  21. package/docs/help/faq.md +16 -16
  22. package/docs/install/installer.md +2 -2
  23. package/docs/providers/github-copilot.md +1 -1
  24. package/docs/start/hubs.md +1 -1
  25. package/docs/start/lore.md +1 -1
  26. package/docs/start/showcase.md +14 -14
  27. package/docs/start/wizard.md +8 -8
  28. package/docs/tools/{clawdhub.md → clawhub.md} +39 -39
  29. package/docs/tools/creating-skills.md +1 -1
  30. package/docs/tools/skills.md +9 -9
  31. package/package.json +1 -1
  32. package/skills/1password/SKILL.md +1 -1
  33. package/skills/bluebubbles/SKILL.md +1 -1
  34. package/skills/canvas/SKILL.md +3 -3
  35. package/skills/clawhub/SKILL.md +53 -0
  36. package/skills/nano-banana-pro/SKILL.md +1 -1
  37. package/skills/openai-whisper-api/SKILL.md +1 -1
  38. package/skills/session-logs/SKILL.md +6 -6
  39. package/skills/sherpa-onnx-tts/SKILL.md +6 -6
  40. package/skills/tmux/SKILL.md +4 -4
  41. package/skills/tmux/scripts/find-sessions.sh +2 -2
  42. 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 `clawdbot/plugin-sdk` helpers.
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)
@@ -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 `~/.clawdbot/openclaw.json`:
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 ~/.clawdbot/openclaw.json | jq '.gateway.bind'
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 ~/.clawdbot/openclaw.json | jq '.gateway.bind'`
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 `~/.clawdbot/openclaw.json`
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`.
@@ -30,7 +30,7 @@ Defaults:
30
30
 
31
31
  ## API key
32
32
 
33
- Set `OPENAI_API_KEY`, or configure it in `~/.clawdbot/openclaw.json`:
33
+ Set `OPENAI_API_KEY`, or configure it in `~/.openclaw/openclaw.json`:
34
34
 
35
35
  ```json5
36
36
  {
@@ -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: `~/.clawdbot/agents/<agentId>/sessions/` (use the `agent=<id>` value from the system prompt Runtime line).
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 ~/.clawdbot/agents/<agentId>/sessions/*.jsonl; do
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 ~/.clawdbot/agents/<agentId>/sessions/*.jsonl; do
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 ~/.clawdbot/agents/<agentId>/sessions/*.jsonl; do
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" ~/.clawdbot/agents/<agentId>/sessions/*.jsonl
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' ~/.clawdbot/agents/<agentId>/sessions/<id>.jsonl | rg 'keyword'
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":"~/.clawdbot/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":"~/.clawdbot/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":"~/.clawdbot/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":"~/.clawdbot/tools/sherpa-onnx-tts/models","label":"Download Piper en_US lessac (high)"}]}}
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 `~/.clawdbot/tools/sherpa-onnx-tts/runtime`)
14
- 2) Download a voice model (extracts into `~/.clawdbot/tools/sherpa-onnx-tts/models`)
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 `~/.clawdbot/openclaw.json`:
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: "~/.clawdbot/tools/sherpa-onnx-tts/runtime",
25
- SHERPA_ONNX_MODEL_DIR: "~/.clawdbot/tools/sherpa-onnx-tts/models/vits-piper-en_US-lessac-high"
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
  }
@@ -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 `CLAWDBOT_TMUX_SOCKET_DIR` (default `${TMPDIR:-/tmp}/openclaw-tmux-sockets`).
35
- - Default socket path: `"$CLAWDBOT_TMUX_SOCKET_DIR/openclaw.sock"`.
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 `CLAWDBOT_TMUX_SOCKET_DIR`).
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 CLAWDBOT_TMUX_SOCKET_DIR
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}/moltbot-tmux-sockets}"
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
@@ -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