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.
- package/CONTRIBUTING.md +1 -1
- package/README.aiclaw.md +1 -1
- package/README.aliclaw.md +1 -1
- package/README.amazonclaw.md +12 -0
- package/README.amzclaw.md +12 -0
- package/README.anthropicclaw.md +12 -0
- package/README.appleclaw.md +12 -0
- package/README.autoopenclaw.md +1 -1
- package/README.awsclaw.md +12 -0
- package/README.bdclaw.md +12 -0
- package/README.blclaw.md +12 -0
- package/README.bytclaw.md +12 -0
- package/README.claw-open.md +1 -1
- package/README.clawjs.md +1 -1
- package/README.coclaw.md +12 -0
- package/README.copaw.md +12 -0
- package/README.ddclaw.md +12 -0
- package/README.duclaw.md +12 -0
- package/README.dyclaw.md +12 -0
- package/README.easyclaw.md +12 -0
- package/README.fastclaw.md +1 -1
- package/README.fbclaw.md +12 -0
- package/README.googleclaw.md +12 -0
- package/README.hwclaw.md +12 -0
- package/README.jdclaw.md +12 -0
- package/README.kimiclaw.md +12 -0
- package/README.ksclaw.md +12 -0
- package/README.maxclaw.md +12 -0
- package/README.md +1 -1
- package/README.megaclaw.md +1 -1
- package/README.metaclaw.md +12 -0
- package/README.miclaw.md +12 -0
- package/README.msclaw.md +12 -0
- package/README.mtclaw.md +12 -0
- package/README.nflxclaw.md +12 -0
- package/README.nvdaclaw.md +12 -0
- package/README.open-claw.md +1 -1
- package/README.openaiclaw.md +12 -0
- package/README.openclaw-cli.md +1 -1
- package/README.openclaw-daemon.md +1 -1
- package/README.openclaw-gateway.md +1 -1
- package/README.openclaw-health.md +1 -1
- package/README.openclaw-helper.md +1 -1
- package/README.openclaw-install.md +1 -1
- package/README.openclaw-manage.md +1 -1
- package/README.openclaw-monitor.md +1 -1
- package/README.openclaw-run.md +1 -1
- package/README.openclaw-service.md +1 -1
- package/README.openclaw-setup.md +1 -1
- package/README.openclaw-start.md +1 -1
- package/README.openclaw-tools.md +1 -1
- package/README.openclaw-upgrade.md +1 -1
- package/README.openclaw-utils.md +1 -1
- package/README.openclaw-watch.md +1 -1
- package/README.pddclaw.md +12 -0
- package/README.qclaw-cli.md +1 -1
- package/README.qclaw.md +1 -1
- package/README.smartclaw.md +1 -1
- package/README.ttclaw.md +12 -0
- package/README.txclaw.md +12 -0
- package/README.uberclaw.md +12 -0
- package/README.volclaw.md +1 -1
- package/README.wxclaw.md +12 -0
- package/README.xclaw.md +12 -0
- package/README.zh-CN.md +2 -2
- package/README.zhclaw.md +12 -0
- package/dist/{chunk-LIZ6XXW3.js → chunk-U6JVOA5H.js} +1 -1
- package/dist/index.js +3 -3
- package/dist/{server-ZYSNFLSO.js → server-GHEIPQJV.js} +1 -1
- package/package.json +3 -3
- package/README.md.bak +0 -242
- package/app-dist/main.js +0 -300
- package/app-dist/package.json +0 -3
- package/app-dist/server-process.js +0 -95
- package/assets/demo.gif +0 -0
- package/assets/welcome.png +0 -0
- package/demo.tape +0 -28
- package/homebrew/README.md +0 -37
- package/homebrew/openclaw-cli.rb +0 -22
- package/homebrew/openclaw-doctor.rb +0 -26
- package/package.aiclaw.json +0 -25
- package/package.aliclaw.json +0 -25
- package/package.autoopenclaw.json +0 -25
- package/package.claw-open.json +0 -25
- package/package.clawjs.json +0 -25
- package/package.fastclaw.json +0 -25
- package/package.json.bak +0 -51
- package/package.megaclaw.json +0 -25
- package/package.open-claw.json +0 -25
- package/package.openclaw-cli.json +0 -51
- package/package.openclaw-daemon.json +0 -51
- package/package.openclaw-gateway.json +0 -51
- package/package.openclaw-health.json +0 -51
- package/package.openclaw-helper.json +0 -51
- package/package.openclaw-install.json +0 -51
- package/package.openclaw-manage.json +0 -51
- package/package.openclaw-monitor.json +0 -51
- package/package.openclaw-run.json +0 -51
- package/package.openclaw-service.json +0 -51
- package/package.openclaw-setup.json +0 -51
- package/package.openclaw-start.json +0 -51
- package/package.openclaw-tools.json +0 -51
- package/package.openclaw-upgrade.json +0 -50
- package/package.openclaw-utils.json +0 -51
- package/package.openclaw-watch.json +0 -51
- package/package.qclaw-cli.json +0 -25
- package/package.qclaw.json +0 -25
- package/package.smartclaw.json +0 -25
- package/package.volclaw.json +0 -25
- package/scripts/post-app-compile.cjs +0 -3
- package/scripts/post-app-compile.js +0 -7
- package/scripts/publish.sh +0 -120
- package/scripts/publish.sh.bak +0 -63
package/README.ttclaw.md
ADDED
|
@@ -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.
|
package/README.txclaw.md
ADDED
|
@@ -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
package/README.wxclaw.md
ADDED
|
@@ -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.
|
package/README.xclaw.md
ADDED
|
@@ -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-
|
|
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-
|
|
184
|
+
git clone https://github.com/Sobranier/openclaw-cli.git
|
|
185
185
|
cd openclaw-doctor
|
|
186
186
|
npm install
|
|
187
187
|
|
package/README.zhclaw.md
ADDED
|
@@ -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.
|
|
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-
|
|
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-
|
|
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.
|
|
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);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "qclaw-cli",
|
|
3
|
-
"version": "0.3.
|
|
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-
|
|
19
|
+
"url": "https://github.com/Sobranier/openclaw-cli.git"
|
|
20
20
|
},
|
|
21
|
-
"homepage": "https://github.com/Sobranier/openclaw-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
24
|
-
<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen" alt="License" /></a>
|
|
25
|
-
|
|
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
|