qclaw-cli 0.3.1 → 0.3.2

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 (113) hide show
  1. package/CONTRIBUTING.md +1 -1
  2. package/README.aiclaw.md +1 -1
  3. package/README.aliclaw.md +1 -1
  4. package/README.amazonclaw.md +12 -0
  5. package/README.amzclaw.md +12 -0
  6. package/README.anthropicclaw.md +12 -0
  7. package/README.appleclaw.md +12 -0
  8. package/README.autoopenclaw.md +1 -1
  9. package/README.awsclaw.md +12 -0
  10. package/README.bdclaw.md +12 -0
  11. package/README.blclaw.md +12 -0
  12. package/README.bytclaw.md +12 -0
  13. package/README.claw-open.md +1 -1
  14. package/README.clawjs.md +1 -1
  15. package/README.coclaw.md +12 -0
  16. package/README.copaw.md +12 -0
  17. package/README.ddclaw.md +12 -0
  18. package/README.duclaw.md +12 -0
  19. package/README.dyclaw.md +12 -0
  20. package/README.easyclaw.md +12 -0
  21. package/README.fastclaw.md +1 -1
  22. package/README.fbclaw.md +12 -0
  23. package/README.googleclaw.md +12 -0
  24. package/README.hwclaw.md +12 -0
  25. package/README.jdclaw.md +12 -0
  26. package/README.kimiclaw.md +12 -0
  27. package/README.ksclaw.md +12 -0
  28. package/README.maxclaw.md +12 -0
  29. package/README.md +1 -1
  30. package/README.megaclaw.md +1 -1
  31. package/README.metaclaw.md +12 -0
  32. package/README.miclaw.md +12 -0
  33. package/README.msclaw.md +12 -0
  34. package/README.mtclaw.md +12 -0
  35. package/README.nflxclaw.md +12 -0
  36. package/README.nvdaclaw.md +12 -0
  37. package/README.open-claw.md +1 -1
  38. package/README.openaiclaw.md +12 -0
  39. package/README.openclaw-cli.md +1 -1
  40. package/README.openclaw-daemon.md +1 -1
  41. package/README.openclaw-gateway.md +1 -1
  42. package/README.openclaw-health.md +1 -1
  43. package/README.openclaw-helper.md +1 -1
  44. package/README.openclaw-install.md +1 -1
  45. package/README.openclaw-manage.md +1 -1
  46. package/README.openclaw-monitor.md +1 -1
  47. package/README.openclaw-run.md +1 -1
  48. package/README.openclaw-service.md +1 -1
  49. package/README.openclaw-setup.md +1 -1
  50. package/README.openclaw-start.md +1 -1
  51. package/README.openclaw-tools.md +1 -1
  52. package/README.openclaw-upgrade.md +1 -1
  53. package/README.openclaw-utils.md +1 -1
  54. package/README.openclaw-watch.md +1 -1
  55. package/README.pddclaw.md +12 -0
  56. package/README.qclaw-cli.md +1 -1
  57. package/README.qclaw.md +1 -1
  58. package/README.smartclaw.md +1 -1
  59. package/README.ttclaw.md +12 -0
  60. package/README.txclaw.md +12 -0
  61. package/README.uberclaw.md +12 -0
  62. package/README.volclaw.md +1 -1
  63. package/README.wxclaw.md +12 -0
  64. package/README.xclaw.md +12 -0
  65. package/README.zh-CN.md +2 -2
  66. package/README.zhclaw.md +12 -0
  67. package/dist/{chunk-LIZ6XXW3.js → chunk-U6JVOA5H.js} +1 -1
  68. package/dist/index.js +3 -3
  69. package/dist/{server-ZYSNFLSO.js → server-GHEIPQJV.js} +1 -1
  70. package/package.json +3 -3
  71. package/README.md.bak +0 -242
  72. package/app-dist/main.js +0 -300
  73. package/app-dist/package.json +0 -3
  74. package/app-dist/server-process.js +0 -95
  75. package/assets/demo.gif +0 -0
  76. package/assets/welcome.png +0 -0
  77. package/demo.tape +0 -28
  78. package/homebrew/README.md +0 -37
  79. package/homebrew/openclaw-cli.rb +0 -22
  80. package/homebrew/openclaw-doctor.rb +0 -26
  81. package/package.aiclaw.json +0 -25
  82. package/package.aliclaw.json +0 -25
  83. package/package.autoopenclaw.json +0 -25
  84. package/package.claw-open.json +0 -25
  85. package/package.clawjs.json +0 -25
  86. package/package.fastclaw.json +0 -25
  87. package/package.json.bak +0 -51
  88. package/package.megaclaw.json +0 -25
  89. package/package.open-claw.json +0 -25
  90. package/package.openclaw-cli.json +0 -51
  91. package/package.openclaw-daemon.json +0 -51
  92. package/package.openclaw-gateway.json +0 -51
  93. package/package.openclaw-health.json +0 -51
  94. package/package.openclaw-helper.json +0 -51
  95. package/package.openclaw-install.json +0 -51
  96. package/package.openclaw-manage.json +0 -51
  97. package/package.openclaw-monitor.json +0 -51
  98. package/package.openclaw-run.json +0 -51
  99. package/package.openclaw-service.json +0 -51
  100. package/package.openclaw-setup.json +0 -51
  101. package/package.openclaw-start.json +0 -51
  102. package/package.openclaw-tools.json +0 -51
  103. package/package.openclaw-upgrade.json +0 -50
  104. package/package.openclaw-utils.json +0 -51
  105. package/package.openclaw-watch.json +0 -51
  106. package/package.qclaw-cli.json +0 -25
  107. package/package.qclaw.json +0 -25
  108. package/package.smartclaw.json +0 -25
  109. package/package.volclaw.json +0 -25
  110. package/scripts/post-app-compile.cjs +0 -3
  111. package/scripts/post-app-compile.js +0 -7
  112. package/scripts/publish.sh +0 -120
  113. package/scripts/publish.sh.bak +0 -63
@@ -0,0 +1,12 @@
1
+ # ttclaw
2
+
3
+ > Alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
4
+
5
+ Watchdog daemon for OpenClaw AI assistant gateway.
6
+
7
+ ```bash
8
+ npm install -g ttclaw
9
+ ttclaw watch -d
10
+ ```
11
+
12
+ See [openclaw-cli](https://github.com/Sobranier/openclaw-cli) for full docs.
@@ -0,0 +1,12 @@
1
+ # txclaw
2
+
3
+ > Alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
4
+
5
+ Watchdog daemon for OpenClaw AI assistant gateway.
6
+
7
+ ```bash
8
+ npm install -g txclaw
9
+ txclaw watch -d
10
+ ```
11
+
12
+ See [openclaw-cli](https://github.com/Sobranier/openclaw-cli) for full docs.
@@ -0,0 +1,12 @@
1
+ # uberclaw
2
+
3
+ > Alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
4
+
5
+ Watchdog daemon for OpenClaw AI assistant gateway.
6
+
7
+ ```bash
8
+ npm install -g uberclaw
9
+ uberclaw watch -d
10
+ ```
11
+
12
+ See [openclaw-cli](https://github.com/Sobranier/openclaw-cli) for full docs.
package/README.volclaw.md CHANGED
@@ -19,4 +19,4 @@ volclaw status # Health check
19
19
  volclaw unwatch # Stop monitoring
20
20
  ```
21
21
 
22
- For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).
22
+ For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-cli).
@@ -0,0 +1,12 @@
1
+ # wxclaw
2
+
3
+ > Alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
4
+
5
+ Watchdog daemon for OpenClaw AI assistant gateway.
6
+
7
+ ```bash
8
+ npm install -g wxclaw
9
+ wxclaw watch -d
10
+ ```
11
+
12
+ See [openclaw-cli](https://github.com/Sobranier/openclaw-cli) for full docs.
@@ -0,0 +1,12 @@
1
+ # xclaw
2
+
3
+ > Alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
4
+
5
+ Watchdog daemon for OpenClaw AI assistant gateway.
6
+
7
+ ```bash
8
+ npm install -g xclaw
9
+ xclaw watch -d
10
+ ```
11
+
12
+ See [openclaw-cli](https://github.com/Sobranier/openclaw-cli) for full docs.
package/README.zh-CN.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <img src="https://raw.githubusercontent.com/Sobranier/openclaw-doctor/main/assets/welcome.png" alt="OpenClaw Doctor" width="400" />
2
+ <img src="https://raw.githubusercontent.com/Sobranier/openclaw-cli/main/assets/welcome.png" alt="OpenClaw Doctor" width="400" />
3
3
  </p>
4
4
 
5
5
  <h1 align="center">OpenClaw Doctor</h1>
@@ -181,7 +181,7 @@ openclaw-doctor watch -d # 幂等——重复调用安全
181
181
  ## 开发
182
182
 
183
183
  ```bash
184
- git clone https://github.com/Sobranier/openclaw-doctor.git
184
+ git clone https://github.com/Sobranier/openclaw-cli.git
185
185
  cd openclaw-doctor
186
186
  npm install
187
187
 
@@ -0,0 +1,12 @@
1
+ # zhclaw
2
+
3
+ > Alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
4
+
5
+ Watchdog daemon for OpenClaw AI assistant gateway.
6
+
7
+ ```bash
8
+ npm install -g zhclaw
9
+ zhclaw watch -d
10
+ ```
11
+
12
+ See [openclaw-cli](https://github.com/Sobranier/openclaw-cli) for full docs.
@@ -572,7 +572,7 @@ function scanCosts(agents) {
572
572
  }
573
573
 
574
574
  // src/dashboard/server.ts
575
- var _PKG_VER = true ? "0.3.1" : "0.2.1";
575
+ var _PKG_VER = true ? "0.3.2" : "0.2.1";
576
576
  var pkgVersion = _PKG_VER;
577
577
  function readDoctorLogs(maxLines = 50) {
578
578
  if (!existsSync6(DOCTOR_LOG_DIR)) return [];
package/dist/index.js CHANGED
@@ -17,7 +17,7 @@ import {
17
17
  startDashboard,
18
18
  startGateway,
19
19
  stopGateway
20
- } from "./chunk-LIZ6XXW3.js";
20
+ } from "./chunk-U6JVOA5H.js";
21
21
 
22
22
  // src/index.ts
23
23
  import { spawnSync } from "child_process";
@@ -43,7 +43,7 @@ async function watchDaemon(options) {
43
43
  log("info", `Check interval: ${config.checkInterval}s`);
44
44
  log("info", `PID: ${process.pid}`);
45
45
  if (options.dashboard) {
46
- const { startDashboard: startDashboard2 } = await import("./server-ZYSNFLSO.js");
46
+ const { startDashboard: startDashboard2 } = await import("./server-GHEIPQJV.js");
47
47
  startDashboard2({ config: options.config });
48
48
  }
49
49
  const throttle = new RestartThrottle(config.maxRestartsPerHour);
@@ -511,7 +511,7 @@ async function memoryCompact(options) {
511
511
  }
512
512
 
513
513
  // src/index.ts
514
- var _PKG_VER = true ? "0.3.1" : "0.2.1";
514
+ var _PKG_VER = true ? "0.3.2" : "0.2.1";
515
515
  var version = _PKG_VER;
516
516
  var program = new Command();
517
517
  program.name(BINARY_NAME).description(`${DISPLAY_NAME} \u2014 health monitor and management for OpenClaw services`).version(version);
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  import {
3
3
  startDashboard
4
- } from "./chunk-LIZ6XXW3.js";
4
+ } from "./chunk-U6JVOA5H.js";
5
5
  export {
6
6
  startDashboard
7
7
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "qclaw-cli",
3
- "version": "0.3.1",
3
+ "version": "0.3.2",
4
4
  "description": "CLI and health-watch daemon for OpenClaw AI assistant gateway",
5
5
  "keywords": [
6
6
  "openclaw",
@@ -16,9 +16,9 @@
16
16
  "license": "MIT",
17
17
  "repository": {
18
18
  "type": "git",
19
- "url": "https://github.com/Sobranier/openclaw-doctor.git"
19
+ "url": "https://github.com/Sobranier/openclaw-cli.git"
20
20
  },
21
- "homepage": "https://github.com/Sobranier/openclaw-doctor",
21
+ "homepage": "https://github.com/Sobranier/openclaw-cli",
22
22
  "engines": {
23
23
  "node": ">=22"
24
24
  }
package/README.md.bak DELETED
@@ -1,242 +0,0 @@
1
- <p align="center">
2
- <img src="https://raw.githubusercontent.com/Sobranier/openclaw-doctor/main/assets/welcome.png" alt="OpenClaw Doctor" width="400" />
3
- </p>
4
-
5
- <h1 align="center">OpenClaw Doctor</h1>
6
-
7
- <p align="center">
8
- Keep your OpenClaw service alive. Automatically.
9
- </p>
10
-
11
- <p align="center">
12
- <a href="./README.zh-CN.md">中文文档</a>
13
- </p>
14
-
15
- <p align="center">
16
- <a href="https://www.npmjs.com/package/openclaw-doctor"><img src="https://img.shields.io/npm/v/openclaw-doctor?label=openclaw-doctor&color=red" alt="npm version" /></a>
17
- &nbsp;
18
- <a href="https://www.npmjs.com/package/openclaw-doctor"><img src="https://img.shields.io/npm/dm/openclaw-doctor?color=red" alt="npm downloads" /></a>
19
- &nbsp;
20
- <a href="https://www.npmjs.com/package/openclaw-cli"><img src="https://img.shields.io/npm/v/openclaw-cli?label=openclaw-cli&color=blue" alt="npm openclaw-cli" /></a>
21
- &nbsp;
22
- <a href="https://www.npmjs.com/package/openclaw-manage"><img src="https://img.shields.io/npm/v/openclaw-manage?label=openclaw-manage&color=green" alt="npm openclaw-manage" /></a>
23
- &nbsp;
24
- <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen" alt="License" /></a>
25
- &nbsp;
26
- <img src="https://img.shields.io/node/v/openclaw-doctor" alt="Node version" />
27
- </p>
28
-
29
- ---
30
-
31
- ## Why Doctor?
32
-
33
- OpenClaw runs as a local daemon. When it crashes — network hiccup, system wake, bad update — your AI assistant goes dark. You notice only when you try to use it.
34
-
35
- **Doctor watches the gateway for you.** It detects failures, restarts the service automatically, and notifies you. No config, no babysitting.
36
-
37
- ## Primary Package
38
-
39
- > **`openclaw-cli` is the primary package.** All package names (`openclaw-doctor`, `openclaw-manage`, `qclaw`, `aiclaw`, etc.) point to the same tool — install whichever name feels right, it works identically.
40
- >
41
- > `openclaw-doctor` is the original name and is kept for backward compatibility.
42
-
43
- ## Get Started
44
-
45
- ```bash
46
- npm install -g openclaw-doctor
47
- openclaw-doctor watch -d
48
- ```
49
-
50
- That's it. Doctor is now running in the background. It reads everything from your existing OpenClaw setup — no configuration needed.
51
-
52
- <p align="center">
53
- <img src="https://raw.githubusercontent.com/Sobranier/openclaw-doctor/main/assets/demo.gif" alt="OpenClaw Doctor demo" width="700" />
54
- </p>
55
-
56
- ## Core Commands
57
-
58
- ```bash
59
- openclaw-doctor watch # Start monitoring (foreground)
60
- openclaw-doctor watch -d # Start monitoring (background)
61
- openclaw-doctor unwatch # Stop monitoring
62
-
63
- openclaw-doctor status # Quick health check
64
- ```
65
-
66
- These four cover 90% of daily use.
67
-
68
- ## Gateway Management
69
-
70
- ```bash
71
- openclaw-doctor gateway start # Start the OpenClaw gateway
72
- openclaw-doctor gateway stop # Stop the gateway
73
- openclaw-doctor gateway restart # Restart the gateway
74
- ```
75
-
76
- ## Diagnostics & Logs
77
-
78
- ```bash
79
- openclaw-doctor doctor # Full diagnostics (binary, gateway, channels)
80
- openclaw-doctor logs # View gateway logs
81
- openclaw-doctor logs --error # Error logs only
82
- openclaw-doctor logs --doctor # Doctor's own event logs
83
- openclaw-doctor dashboard # Web management UI → http://localhost:9090
84
- ```
85
-
86
- ## Install
87
-
88
- ```bash
89
- # npm (recommended)
90
- npm install -g openclaw-doctor
91
-
92
- # Run without installing
93
- npx openclaw-doctor status
94
- ```
95
-
96
- > Requires Node.js >= 22 (same as OpenClaw).
97
-
98
- ## How It Works
99
-
100
- Doctor auto-detects your OpenClaw installation — no manual config:
101
-
102
- - Reads `~/.openclaw/openclaw.json` for gateway port, channels, and agents
103
- - Finds the launchd service under `~/Library/LaunchAgents/`
104
- - Checks health via `openclaw health --json` (real gateway RPC, not HTTP ping)
105
- - Restarts via `launchctl kickstart` when consecutive failures exceed the threshold
106
-
107
- ## All Commands
108
-
109
- | Command | Description |
110
- |---------|-------------|
111
- | `watch` | Start health monitoring (foreground) |
112
- | `watch -d` | Start health monitoring (background) |
113
- | `watch -d --dashboard` | Background monitoring + web dashboard |
114
- | `unwatch` | Stop monitoring |
115
- | `gateway start` | Start the OpenClaw gateway |
116
- | `gateway stop` | Stop the gateway |
117
- | `gateway restart` | Restart the gateway |
118
- | `status` | Show gateway and channel health |
119
- | `status --json` | Machine-readable JSON output |
120
- | `doctor` | Run full diagnostics |
121
- | `dashboard` | Start web management UI |
122
- | `logs` | Show gateway logs |
123
- | `logs --error` | Error logs only |
124
- | `logs --doctor` | Doctor event logs |
125
-
126
- ## Configuration
127
-
128
- Auto-created at `~/.openclaw-doctor/config.json` on first run.
129
-
130
- ```json
131
- {
132
- "checkInterval": 30,
133
- "failThreshold": 3,
134
- "dashboardPort": 9090,
135
- "maxRestartsPerHour": 5,
136
- "openclawProfile": "default",
137
- "notify": {
138
- "webhook": {
139
- "enabled": false,
140
- "url": "",
141
- "bodyTemplate": "{\"msgtype\":\"text\",\"text\":{\"content\":\"{{message}}\"}}"
142
- },
143
- "system": {
144
- "enabled": true
145
- }
146
- }
147
- }
148
- ```
149
-
150
- | Field | Default | Description |
151
- |-------|---------|-------------|
152
- | `checkInterval` | `30` | Seconds between health checks |
153
- | `failThreshold` | `3` | Consecutive failures before restart |
154
- | `dashboardPort` | `9090` | Web dashboard port |
155
- | `maxRestartsPerHour` | `5` | Restart throttle (prevents restart loops) |
156
- | `openclawProfile` | `"default"` | OpenClaw profile to monitor |
157
- | `notify.webhook.url` | — | Webhook URL (DingTalk, Feishu, Slack, etc.) |
158
- | `notify.system.enabled` | `true` | macOS native notifications |
159
-
160
- ## Notifications
161
-
162
- Doctor covers the full restart lifecycle:
163
-
164
- | Event | Message |
165
- |-------|---------|
166
- | Started | "Doctor is watching your OpenClaw service" |
167
- | Degraded | "Service unhealthy (attempt 2/3)" |
168
- | Restarting | "Restarting gateway..." |
169
- | Recovered | "Gateway back online" |
170
- | Failed | "Restart failed: [error]" |
171
- | Throttled | "Too many restarts — manual intervention needed" |
172
- | Self-recovered | "Service recovered on its own" |
173
- | Stopped | "Doctor stopped" |
174
-
175
- **Channels:** Webhook (DingTalk, Feishu, Slack, custom) + macOS system notifications.
176
-
177
- ## Architecture
178
-
179
- ```
180
- +-----------------+
181
- | Notification |
182
- | (Webhook/OS) |
183
- +--------^--------+
184
- |
185
- +-------------+ CLI +--------+--------+ RPC +-----------+
186
- | OpenClaw | --------> | | ---------> | OpenClaw |
187
- | / Scripts | | openclaw-doctor | | Gateway |
188
- | / Skills | <-------- | (daemon) | <--------- | :18789 |
189
- +-------------+ stdout +--------+--------+ health +-----------+
190
- |
191
- +--------v--------+
192
- | ~/.openclaw/logs |
193
- | (read & analyze) |
194
- +-----------------+
195
- ```
196
-
197
- Doctor runs as a standalone daemon. If the calling process crashes, Doctor keeps running.
198
-
199
- ```bash
200
- openclaw-doctor status --json # Machine-readable — pipe into scripts or agents
201
- openclaw-doctor watch -d # Idempotent — safe to call repeatedly
202
- ```
203
-
204
- ## Roadmap
205
-
206
- - [x] Health check via `openclaw health --json` + auto-restart with throttling
207
- - [x] Auto-detect OpenClaw config (gateway port, channels, agents, launchd)
208
- - [x] Background daemon mode (`watch -d` / `unwatch`)
209
- - [x] Gateway management (`gateway start/stop/restart`)
210
- - [x] Read and display OpenClaw gateway logs
211
- - [x] Web status dashboard
212
- - [x] `--json` output for status
213
- - [ ] Notification system (Webhook + macOS)
214
- - [ ] `logs --tail` (real-time follow)
215
- - [ ] `config` command (get/set)
216
- - [ ] Multiple service monitoring
217
- - [ ] Linux systemd support
218
-
219
- ## Development
220
-
221
- ```bash
222
- git clone https://github.com/Sobranier/openclaw-doctor.git
223
- cd openclaw-doctor
224
- npm install
225
-
226
- npm run dev -- status # Quick test
227
- npm run dev -- watch # Foreground monitoring
228
- npm run dev -- watch -d # Background daemon
229
- npm run dev -- unwatch # Stop daemon
230
-
231
- npm run build # Build for distribution
232
- ```
233
-
234
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for the release and publish workflow.
235
-
236
- ## License
237
-
238
- [MIT](./LICENSE)
239
-
240
- ---
241
-
242
- Works with [OpenClaw](https://openclaw.ai) · Built for the OpenClaw ecosystem