hello-claw 0.3.3

package/README.openclaw-utils.md

@@ -0,0 +1,239 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Sobranier/openclaw-cli/main/assets/welcome.png" alt="OpenClaw utils" width="400" />
+</p>
+
+<h1 align="center">OpenClaw utils</h1>
+
+<p align="center">
+  Keep your OpenClaw service alive. Automatically.
+</p>
+
+<p align="center">
+  <a href="./README.zh-CN.md">中文文档</a>
+</p>
+
+## Get Started
+
+```bash
+npm install -g openclaw-utils
+openclaw-utils watch -d
+```
+
+That's it. Doctor monitors your OpenClaw gateway in the background, restarts it when it goes down, and tells you what happened. Zero configuration needed -- it reads everything from your existing OpenClaw setup.
+
+## Core Commands
+
+```bash
+openclaw-utils watch            # Start monitoring (foreground)
+openclaw-utils watch -d         # Start monitoring (background)
+openclaw-utils unwatch          # Stop monitoring
+
+openclaw-utils status           # Quick health check
+```
+
+These four commands cover 90% of daily use.
+
+## Gateway Management
+
+```bash
+openclaw-utils gateway start    # Start the OpenClaw gateway
+openclaw-utils gateway stop     # Stop the gateway
+openclaw-utils gateway restart  # Restart the gateway
+```
+
+## Diagnostics & Logs
+
+```bash
+openclaw-utils doctor           # Full diagnostics (binary, gateway, channels)
+openclaw-utils logs             # View gateway logs
+openclaw-utils logs --error     # View error logs only
+openclaw-utils logs --doctor    # View Doctor's own event logs
+openclaw-utils dashboard        # Web management UI (http://localhost:9090)
+```
+
+## Install
+
+```bash
+# npm (recommended)
+npm install -g openclaw-utils
+
+# or run without installing
+npx openclaw-utils status
+```
+
+Requires Node >= 22 (same as OpenClaw).
+
+## How It Works
+
+Doctor auto-detects your OpenClaw installation:
+
+- Reads `~/.openclaw/openclaw.json` for gateway port, channels, agents
+- Finds the launchd service from `~/Library/LaunchAgents/`
+- Checks health via `openclaw health --json` (real gateway RPC, not HTTP)
+- Restarts via `launchctl kickstart` when needed
+
+**You don't configure OpenClaw details.** Doctor figures them out.
+
+## All Commands
+
+| Command | Description |
+|---------|-------------|
+| **Monitoring** | |
+| `watch` | Start health monitoring (foreground) |
+| `watch -d` | Start health monitoring (background) |
+| `watch -d --dashboard` | Background monitoring + web dashboard |
+| `unwatch` | Stop monitoring |
+| **Gateway** | |
+| `gateway start` | Start the OpenClaw gateway |
+| `gateway stop` | Stop the gateway |
+| `gateway restart` | Restart the gateway |
+| **Info** | |
+| `status` | Show gateway and channel health |
+| `status --json` | Machine-readable JSON output |
+| `doctor` | Run full diagnostics |
+| `dashboard` | Start web management UI |
+| `logs` | Show gateway logs |
+| `logs --error` | Show error logs only |
+| `logs --doctor` | Show Doctor event logs |
+
+## Configuration
+
+Config is stored at `~/.openclaw-doctor/config.json`. Created automatically on first run. Only Doctor's own preferences -- no OpenClaw settings needed.
+
+```json
+{
+  "checkInterval": 30,
+  "failThreshold": 3,
+  "dashboardPort": 9090,
+  "maxRestartsPerHour": 5,
+  "openclawProfile": "default",
+  "notify": {
+    "webhook": {
+      "enabled": false,
+      "url": "",
+      "bodyTemplate": "{\"msgtype\":\"text\",\"text\":{\"content\":\"{{message}}\"}}"
+    },
+    "system": {
+      "enabled": true
+    }
+  }
+}
+```
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| `checkInterval` | Seconds between health checks | `30` |
+| `failThreshold` | Consecutive failures before restart | `3` |
+| `dashboardPort` | Web dashboard port | `9090` |
+| `maxRestartsPerHour` | Restart throttle | `5` |
+| `openclawProfile` | OpenClaw profile to monitor (`default`, `dev`, ...) | `default` |
+| `notify.webhook.url` | Webhook for notifications | -- |
+| `notify.system.enabled` | macOS native notifications | `true` |
+
+## Notifications
+
+Doctor notifies you across the full lifecycle:
+
+| Event | Example |
+|-------|---------|
+| Monitoring started | "Doctor is watching your OpenClaw service" |
+| Health degraded | "Service unhealthy (attempt 2/3)" |
+| Restarting | "Restarting gateway..." |
+| Restart succeeded | "Gateway back online" |
+| Restart failed | "Restart failed: [error]" |
+| Throttled | "Too many restarts, manual intervention needed" |
+| Recovered | "Service recovered on its own" |
+| Monitoring stopped | "Doctor stopped" |
+
+Channels: **Webhook** (DingTalk, Feishu, Slack, etc.) + **macOS system notifications**.
+
+## Skills Integration
+
+Doctor runs as a standalone daemon, callable by OpenClaw or other tools:
+
+```bash
+openclaw-utils status --json    # Machine-readable output
+openclaw-utils watch -d         # Idempotent -- safe to call repeatedly
+```
+
+If the caller crashes, Doctor keeps running.
+
+## Architecture
+
+```
+                          +-----------------+
+                          |  Notification   |
+                          |  (Webhook/OS)   |
+                          +--------^--------+
+                                   |
++-------------+    CLI    +--------+--------+    RPC      +-----------+
+|  OpenClaw   | --------> |                 | ---------> |  OpenClaw |
+|  / Scripts  |           | openclaw-doctor |            |  Gateway  |
+|  / Skills   | <-------- |  (daemon)       | <--------- | :18789    |
++-------------+  stdout   +--------+--------+  health    +-----------+
+                                   |
+                          +--------v--------+
+                          | ~/.openclaw/logs |
+                          | (read & analyze) |
+                          +-----------------+
+```
+
+## Development
+
+```bash
+git clone https://github.com/openclaw/openclaw-doctor.git
+cd openclaw-doctor
+npm install
+
+npm run dev -- status          # Quick test
+npm run dev -- watch           # Foreground monitoring
+npm run dev -- watch -d        # Background daemon
+npm run dev -- unwatch         # Stop daemon
+
+npm run build                  # Build for distribution
+```
+
+## Roadmap
+
+- [x] Health check via `openclaw health --json` + auto-restart with throttling
+- [x] Auto-detect OpenClaw config (gateway port, channels, agents, launchd)
+- [x] Background daemon mode (`watch -d` / `unwatch`)
+- [x] Gateway management (`gateway start/stop/restart`)
+- [x] Read and display OpenClaw gateway logs
+- [x] Web status dashboard
+- [x] `--json` output for status
+- [ ] Notification system (Webhook + macOS)
+- [ ] `logs --tail` (real-time follow)
+- [ ] `config` command (get/set)
+- [ ] Multiple service monitoring
+- [ ] Linux systemd support
+
+## License
+
+[MIT](./LICENSE)
+
+## Publishing
+
+This repo publishes two npm packages from the same codebase:
+
+- **`openclaw-utils`** — the main package (`package.json`)
+- **`openclaw-utils`** — alias package (`package.openclaw-utils.json`)
+
+Both packages share the same version number and dist output.
+
+### Release a new version
+
+```bash
+# 1. Bump version (patch / minor / major)
+npm version patch
+
+# 2. Build + publish both packages
+npm run release
+```
+
+`npm run release` calls `scripts/publish.sh`, which:
+1. Builds once (`npm run build`)
+2. Publishes `openclaw-utils` with the default `package.json`
+3. Temporarily swaps in `package.openclaw-utils.json`, publishes `openclaw-utils`, then restores
+
+To update the `openclaw-utils` package metadata (description, keywords, bin name, etc.), edit `package.openclaw-utils.json`. Keep `version` in sync — it's automatically picked up from whichever `package.json` is active during publish.

package/README.openclaw-watch.md

@@ -0,0 +1,239 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Sobranier/openclaw-cli/main/assets/welcome.png" alt="OpenClaw watch" width="400" />
+</p>
+
+<h1 align="center">OpenClaw watch</h1>
+
+<p align="center">
+  Keep your OpenClaw service alive. Automatically.
+</p>
+
+<p align="center">
+  <a href="./README.zh-CN.md">中文文档</a>
+</p>
+
+## Get Started
+
+```bash
+npm install -g openclaw-watch
+openclaw-watch watch -d
+```
+
+That's it. Doctor monitors your OpenClaw gateway in the background, restarts it when it goes down, and tells you what happened. Zero configuration needed -- it reads everything from your existing OpenClaw setup.
+
+## Core Commands
+
+```bash
+openclaw-watch watch            # Start monitoring (foreground)
+openclaw-watch watch -d         # Start monitoring (background)
+openclaw-watch unwatch          # Stop monitoring
+
+openclaw-watch status           # Quick health check
+```
+
+These four commands cover 90% of daily use.
+
+## Gateway Management
+
+```bash
+openclaw-watch gateway start    # Start the OpenClaw gateway
+openclaw-watch gateway stop     # Stop the gateway
+openclaw-watch gateway restart  # Restart the gateway
+```
+
+## Diagnostics & Logs
+
+```bash
+openclaw-watch doctor           # Full diagnostics (binary, gateway, channels)
+openclaw-watch logs             # View gateway logs
+openclaw-watch logs --error     # View error logs only
+openclaw-watch logs --doctor    # View Doctor's own event logs
+openclaw-watch dashboard        # Web management UI (http://localhost:9090)
+```
+
+## Install
+
+```bash
+# npm (recommended)
+npm install -g openclaw-watch
+
+# or run without installing
+npx openclaw-watch status
+```
+
+Requires Node >= 22 (same as OpenClaw).
+
+## How It Works
+
+Doctor auto-detects your OpenClaw installation:
+
+- Reads `~/.openclaw/openclaw.json` for gateway port, channels, agents
+- Finds the launchd service from `~/Library/LaunchAgents/`
+- Checks health via `openclaw health --json` (real gateway RPC, not HTTP)
+- Restarts via `launchctl kickstart` when needed
+
+**You don't configure OpenClaw details.** Doctor figures them out.
+
+## All Commands
+
+| Command | Description |
+|---------|-------------|
+| **Monitoring** | |
+| `watch` | Start health monitoring (foreground) |
+| `watch -d` | Start health monitoring (background) |
+| `watch -d --dashboard` | Background monitoring + web dashboard |
+| `unwatch` | Stop monitoring |
+| **Gateway** | |
+| `gateway start` | Start the OpenClaw gateway |
+| `gateway stop` | Stop the gateway |
+| `gateway restart` | Restart the gateway |
+| **Info** | |
+| `status` | Show gateway and channel health |
+| `status --json` | Machine-readable JSON output |
+| `doctor` | Run full diagnostics |
+| `dashboard` | Start web management UI |
+| `logs` | Show gateway logs |
+| `logs --error` | Show error logs only |
+| `logs --doctor` | Show Doctor event logs |
+
+## Configuration
+
+Config is stored at `~/.openclaw-doctor/config.json`. Created automatically on first run. Only Doctor's own preferences -- no OpenClaw settings needed.
+
+```json
+{
+  "checkInterval": 30,
+  "failThreshold": 3,
+  "dashboardPort": 9090,
+  "maxRestartsPerHour": 5,
+  "openclawProfile": "default",
+  "notify": {
+    "webhook": {
+      "enabled": false,
+      "url": "",
+      "bodyTemplate": "{\"msgtype\":\"text\",\"text\":{\"content\":\"{{message}}\"}}"
+    },
+    "system": {
+      "enabled": true
+    }
+  }
+}
+```
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| `checkInterval` | Seconds between health checks | `30` |
+| `failThreshold` | Consecutive failures before restart | `3` |
+| `dashboardPort` | Web dashboard port | `9090` |
+| `maxRestartsPerHour` | Restart throttle | `5` |
+| `openclawProfile` | OpenClaw profile to monitor (`default`, `dev`, ...) | `default` |
+| `notify.webhook.url` | Webhook for notifications | -- |
+| `notify.system.enabled` | macOS native notifications | `true` |
+
+## Notifications
+
+Doctor notifies you across the full lifecycle:
+
+| Event | Example |
+|-------|---------|
+| Monitoring started | "Doctor is watching your OpenClaw service" |
+| Health degraded | "Service unhealthy (attempt 2/3)" |
+| Restarting | "Restarting gateway..." |
+| Restart succeeded | "Gateway back online" |
+| Restart failed | "Restart failed: [error]" |
+| Throttled | "Too many restarts, manual intervention needed" |
+| Recovered | "Service recovered on its own" |
+| Monitoring stopped | "Doctor stopped" |
+
+Channels: **Webhook** (DingTalk, Feishu, Slack, etc.) + **macOS system notifications**.
+
+## Skills Integration
+
+Doctor runs as a standalone daemon, callable by OpenClaw or other tools:
+
+```bash
+openclaw-watch status --json    # Machine-readable output
+openclaw-watch watch -d         # Idempotent -- safe to call repeatedly
+```
+
+If the caller crashes, Doctor keeps running.
+
+## Architecture
+
+```
+                          +-----------------+
+                          |  Notification   |
+                          |  (Webhook/OS)   |
+                          +--------^--------+
+                                   |
++-------------+    CLI    +--------+--------+    RPC      +-----------+
+|  OpenClaw   | --------> |                 | ---------> |  OpenClaw |
+|  / Scripts  |           | openclaw-doctor |            |  Gateway  |
+|  / Skills   | <-------- |  (daemon)       | <--------- | :18789    |
++-------------+  stdout   +--------+--------+  health    +-----------+
+                                   |
+                          +--------v--------+
+                          | ~/.openclaw/logs |
+                          | (read & analyze) |
+                          +-----------------+
+```
+
+## Development
+
+```bash
+git clone https://github.com/openclaw/openclaw-doctor.git
+cd openclaw-doctor
+npm install
+
+npm run dev -- status          # Quick test
+npm run dev -- watch           # Foreground monitoring
+npm run dev -- watch -d        # Background daemon
+npm run dev -- unwatch         # Stop daemon
+
+npm run build                  # Build for distribution
+```
+
+## Roadmap
+
+- [x] Health check via `openclaw health --json` + auto-restart with throttling
+- [x] Auto-detect OpenClaw config (gateway port, channels, agents, launchd)
+- [x] Background daemon mode (`watch -d` / `unwatch`)
+- [x] Gateway management (`gateway start/stop/restart`)
+- [x] Read and display OpenClaw gateway logs
+- [x] Web status dashboard
+- [x] `--json` output for status
+- [ ] Notification system (Webhook + macOS)
+- [ ] `logs --tail` (real-time follow)
+- [ ] `config` command (get/set)
+- [ ] Multiple service monitoring
+- [ ] Linux systemd support
+
+## License
+
+[MIT](./LICENSE)
+
+## Publishing
+
+This repo publishes two npm packages from the same codebase:
+
+- **`openclaw-watch`** — the main package (`package.json`)
+- **`openclaw-watch`** — alias package (`package.openclaw-watch.json`)
+
+Both packages share the same version number and dist output.
+
+### Release a new version
+
+```bash
+# 1. Bump version (patch / minor / major)
+npm version patch
+
+# 2. Build + publish both packages
+npm run release
+```
+
+`npm run release` calls `scripts/publish.sh`, which:
+1. Builds once (`npm run build`)
+2. Publishes `openclaw-watch` with the default `package.json`
+3. Temporarily swaps in `package.openclaw-watch.json`, publishes `openclaw-watch`, then restores
+
+To update the `openclaw-watch` package metadata (description, keywords, bin name, etc.), edit `package.openclaw-watch.json`. Keep `version` in sync — it's automatically picked up from whichever `package.json` is active during publish.

package/README.pddclaw.md

@@ -0,0 +1,20 @@
+# pddclaw
+
+> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+
+## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+
+Install and run:
+
+```bash
+npm install -g pddclaw
+pddclaw watch -d
+```
+
+This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+
+## Links
+
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 🌐 Website: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📖 Docs & Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.qclaw-cli.md

@@ -0,0 +1,20 @@
+# qclaw-cli
+
+> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+
+## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+
+Install and run:
+
+```bash
+npm install -g qclaw-cli
+qclaw-cli watch -d
+```
+
+This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+
+## Links
+
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 🌐 Website: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📖 Docs & Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.qclaw.md

@@ -0,0 +1,22 @@
+# qclaw
+
+> This package is an alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
+
+CLI and health-watch daemon for OpenClaw AI assistant gateway.
+
+## Install
+
+```bash
+npm install -g qclaw
+qclaw watch -d
+```
+
+## Usage
+
+```bash
+qclaw watch -d       # Start background monitoring
+qclaw status         # Health check
+qclaw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-cli).

package/README.smartclaw.md

@@ -0,0 +1,20 @@
+# smartclaw
+
+> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+
+## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+
+Install and run:
+
+```bash
+npm install -g smartclaw
+smartclaw watch -d
+```
+
+This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+
+## Links
+
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 🌐 Website: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📖 Docs & Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.ttclaw.md

@@ -0,0 +1,20 @@
+# ttclaw
+
+> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+
+## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+
+Install and run:
+
+```bash
+npm install -g ttclaw
+ttclaw watch -d
+```
+
+This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+
+## Links
+
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 🌐 Website: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📖 Docs & Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.txclaw.md

@@ -0,0 +1,20 @@
+# txclaw
+
+> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+
+## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+
+Install and run:
+
+```bash
+npm install -g txclaw
+txclaw watch -d
+```
+
+This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+
+## Links
+
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 🌐 Website: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📖 Docs & Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.uberclaw.md

@@ -0,0 +1,20 @@
+# uberclaw
+
+> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+
+## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+
+Install and run:
+
+```bash
+npm install -g uberclaw
+uberclaw watch -d
+```
+
+This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+
+## Links
+
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 🌐 Website: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📖 Docs & Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.volclaw.md

@@ -0,0 +1,20 @@
+# volclaw
+
+> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+
+## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+
+Install and run:
+
+```bash
+npm install -g volclaw
+volclaw watch -d
+```
+
+This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+
+## Links
+
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 🌐 Website: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📖 Docs & Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.wxclaw.md

@@ -0,0 +1,20 @@
+# wxclaw
+
+> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+
+## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+
+Install and run:
+
+```bash
+npm install -g wxclaw
+wxclaw watch -d
+```
+
+This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+
+## Links
+
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 🌐 Website: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📖 Docs & Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.xclaw.md

@@ -0,0 +1,12 @@
+# xclaw
+
+> Alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
+
+Watchdog daemon for OpenClaw AI assistant gateway.
+
+```bash
+npm install -g xclaw
+xclaw watch -d
+```
+
+See [openclaw-cli](https://github.com/Sobranier/openclaw-cli) for full docs.