openclaw-tools 0.2.1 → 0.3.1

package/README.aiclaw.md

@@ -0,0 +1,22 @@
+# aiclaw
+
+> 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 aiclaw
+aiclaw watch -d
+```
+
+## Usage
+
+```bash
+aiclaw watch -d       # Start background monitoring
+aiclaw status         # Health check
+aiclaw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.aliclaw.md

@@ -0,0 +1,22 @@
+# aliclaw
+
+> 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 aliclaw
+aliclaw watch -d
+```
+
+## Usage
+
+```bash
+aliclaw watch -d       # Start background monitoring
+aliclaw status         # Health check
+aliclaw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.autoopenclaw.md

@@ -0,0 +1,22 @@
+# autoopenclaw
+
+> 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 autoopenclaw
+autoopenclaw watch -d
+```
+
+## Usage
+
+```bash
+autoopenclaw watch -d       # Start background monitoring
+autoopenclaw status         # Health check
+autoopenclaw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.claw-open.md

@@ -0,0 +1,22 @@
+# claw-open
+
+> 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 claw-open
+claw-open watch -d
+```
+
+## Usage
+
+```bash
+claw-open watch -d       # Start background monitoring
+claw-open status         # Health check
+claw-open unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.clawjs.md

@@ -0,0 +1,22 @@
+# clawjs
+
+> 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 clawjs
+clawjs watch -d
+```
+
+## Usage
+
+```bash
+clawjs watch -d       # Start background monitoring
+clawjs status         # Health check
+clawjs unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.fastclaw.md

@@ -0,0 +1,22 @@
+# fastclaw
+
+> 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 fastclaw
+fastclaw watch -d
+```
+
+## Usage
+
+```bash
+fastclaw watch -d       # Start background monitoring
+fastclaw status         # Health check
+fastclaw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.md.bak

@@ -13,13 +13,33 @@
 </p>
 
 <p align="center">
-  <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 openclaw-doctor" /></a>
+  <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>
+  &nbsp;
+  <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>
   &nbsp;
   <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>
   &nbsp;
   <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>
+  &nbsp;
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen" alt="License" /></a>
+  &nbsp;
+  <img src="https://img.shields.io/node/v/openclaw-doctor" alt="Node version" />
 </p>
 
+---
+
+## Why Doctor?
+
+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.
+
+**Doctor watches the gateway for you.** It detects failures, restarts the service automatically, and notifies you. No config, no babysitting.
+
+## Primary Package
+
+> **`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.
+>
+> `openclaw-doctor` is the original name and is kept for backward compatibility.
+
 ## Get Started
 
 ```bash
@@ -27,7 +47,11 @@ npm install -g openclaw-doctor
 openclaw-doctor 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.
+That's it. Doctor is now running in the background. It reads everything from your existing OpenClaw setup — no configuration needed.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Sobranier/openclaw-doctor/main/assets/demo.gif" alt="OpenClaw Doctor demo" width="700" />
+</p>
 
 ## Core Commands
 
@@ -39,7 +63,7 @@ openclaw-doctor unwatch          # Stop monitoring
 openclaw-doctor status           # Quick health check
 ```
 
-These four commands cover 90% of daily use.
+These four cover 90% of daily use.
 
 ## Gateway Management
 
@@ -54,9 +78,9 @@ openclaw-doctor gateway restart  # Restart the gateway
 ```bash
 openclaw-doctor doctor           # Full diagnostics (binary, gateway, channels)
 openclaw-doctor logs             # View gateway logs
-openclaw-doctor logs --error     # View error logs only
-openclaw-doctor logs --doctor    # View Doctor's own event logs
-openclaw-doctor dashboard        # Web management UI (http://localhost:9090)
+openclaw-doctor logs --error     # Error logs only
+openclaw-doctor logs --doctor    # Doctor's own event logs
+openclaw-doctor dashboard        # Web management UI → http://localhost:9090
 ```
 
 ## Install
@@ -65,48 +89,43 @@ openclaw-doctor dashboard        # Web management UI (http://localhost:9090)
 # npm (recommended)
 npm install -g openclaw-doctor
 
-# or run without installing
+# Run without installing
 npx openclaw-doctor status
 ```
 
-Requires Node >= 22 (same as OpenClaw).
+> Requires Node.js >= 22 (same as OpenClaw).
 
 ## How It Works
 
-Doctor auto-detects your OpenClaw installation:
+Doctor auto-detects your OpenClaw installation — no manual config:
 
-- 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.
+- Reads `~/.openclaw/openclaw.json` for gateway port, channels, and agents
+- Finds the launchd service under `~/Library/LaunchAgents/`
+- Checks health via `openclaw health --json` (real gateway RPC, not HTTP ping)
+- Restarts via `launchctl kickstart` when consecutive failures exceed the threshold
 
 ## 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 |
+| `logs --error` | Error logs only |
+| `logs --doctor` | 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.
+Auto-created at `~/.openclaw-doctor/config.json` on first run.
 
 ```json
 {
@@ -128,43 +147,32 @@ Config is stored at `~/.openclaw-doctor/config.json`. Created automatically on f
 }
 ```
 
-| 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` |
+| Field | Default | Description |
+|-------|---------|-------------|
+| `checkInterval` | `30` | Seconds between health checks |
+| `failThreshold` | `3` | Consecutive failures before restart |
+| `dashboardPort` | `9090` | Web dashboard port |
+| `maxRestartsPerHour` | `5` | Restart throttle (prevents restart loops) |
+| `openclawProfile` | `"default"` | OpenClaw profile to monitor |
+| `notify.webhook.url` | — | Webhook URL (DingTalk, Feishu, Slack, etc.) |
+| `notify.system.enabled` | `true` | macOS native notifications |
 
 ## Notifications
 
-Doctor notifies you across the full lifecycle:
+Doctor covers the full restart lifecycle:
 
-| Event | Example |
+| Event | Message |
 |-------|---------|
-| Monitoring started | "Doctor is watching your OpenClaw service" |
-| Health degraded | "Service unhealthy (attempt 2/3)" |
+| Started | "Doctor is watching your OpenClaw service" |
+| 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-doctor status --json    # Machine-readable output
-openclaw-doctor watch -d         # Idempotent -- safe to call repeatedly
-```
+| Recovered | "Gateway back online" |
+| Failed | "Restart failed: [error]" |
+| Throttled | "Too many restarts — manual intervention needed" |
+| Self-recovered | "Service recovered on its own" |
+| Stopped | "Doctor stopped" |
 
-If the caller crashes, Doctor keeps running.
+**Channels:** Webhook (DingTalk, Feishu, Slack, custom) + macOS system notifications.
 
 ## Architecture
 
@@ -186,19 +194,11 @@ If the caller crashes, Doctor keeps running.
                           +-----------------+
 ```
 
-## Development
+Doctor runs as a standalone daemon. If the calling process crashes, Doctor keeps running.
 
 ```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
+openclaw-doctor status --json    # Machine-readable — pipe into scripts or agents
+openclaw-doctor watch -d         # Idempotent — safe to call repeatedly
 ```
 
 ## Roadmap
@@ -216,32 +216,27 @@ npm run build                  # Build for distribution
 - [ ] Multiple service monitoring
 - [ ] Linux systemd support
 
-## License
-
-[MIT](./LICENSE)
-
-## Publishing
+## Development
 
-This repo publishes two npm packages from the same codebase:
+```bash
+git clone https://github.com/Sobranier/openclaw-doctor.git
+cd openclaw-doctor
+npm install
 
-- **`openclaw-doctor`** — the main package (`package.json`)
-- **`openclaw-cli`** — alias package (`package.openclaw-cli.json`)
+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
 
-Both packages share the same version number and dist output.
+npm run build                  # Build for distribution
+```
 
-### Release a new version
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the release and publish workflow.
 
-```bash
-# 1. Bump version (patch / minor / major)
-npm version patch
+## License
 
-# 2. Build + publish both packages
-npm run release
-```
+[MIT](./LICENSE)
 
-`npm run release` calls `scripts/publish.sh`, which:
-1. Builds once (`npm run build`)
-2. Publishes `openclaw-doctor` with the default `package.json`
-3. Temporarily swaps in `package.openclaw-cli.json`, publishes `openclaw-cli`, then restores
+---
 
-To update the `openclaw-cli` package metadata (description, keywords, bin name, etc.), edit `package.openclaw-cli.json`. Keep `version` in sync — it's automatically picked up from whichever `package.json` is active during publish.
+Works with [OpenClaw](https://openclaw.ai) · Built for the OpenClaw ecosystem

package/README.megaclaw.md

@@ -0,0 +1,22 @@
+# megaclaw
+
+> 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 megaclaw
+megaclaw watch -d
+```
+
+## Usage
+
+```bash
+megaclaw watch -d       # Start background monitoring
+megaclaw status         # Health check
+megaclaw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.open-claw.md

@@ -0,0 +1,22 @@
+# open-claw
+
+> 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 open-claw
+open-claw watch -d
+```
+
+## Usage
+
+```bash
+open-claw watch -d       # Start background monitoring
+open-claw status         # Health check
+open-claw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.openclaw-upgrade.md

@@ -0,0 +1,13 @@
+# openclaw-upgrade
+
+> Alias package for [openclaw-doctor](https://www.npmjs.com/package/openclaw-doctor)
+
+```bash
+npm install -g openclaw-upgrade
+openclaw-upgrade doctor --fix
+openclaw-upgrade gateway restart
+openclaw-upgrade status
+```
+
+This is an alias. All commands are identical to `openclaw-doctor`.
+See the [full documentation](https://github.com/Sobranier/openclaw-doctor#readme).

package/README.qclaw-cli.md

@@ -0,0 +1,22 @@
+# qclaw-cli
+
+> 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-cli
+qclaw-cli watch -d
+```
+
+## Usage
+
+```bash
+qclaw-cli watch -d       # Start background monitoring
+qclaw-cli status         # Health check
+qclaw-cli unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

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-doctor).

package/README.smartclaw.md

@@ -0,0 +1,22 @@
+# smartclaw
+
+> 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 smartclaw
+smartclaw watch -d
+```
+
+## Usage
+
+```bash
+smartclaw watch -d       # Start background monitoring
+smartclaw status         # Health check
+smartclaw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).

package/README.volclaw.md

@@ -0,0 +1,22 @@
+# volclaw
+
+> 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 volclaw
+volclaw watch -d
+```
+
+## Usage
+
+```bash
+volclaw watch -d       # Start background monitoring
+volclaw status         # Health check
+volclaw unwatch        # Stop monitoring
+```
+
+For full documentation, see [openclaw-cli](https://github.com/Sobranier/openclaw-doctor).