smartclaw 0.3.1

package/CONTRIBUTING.md

@@ -0,0 +1,105 @@
+# Contributing to OpenClaw Doctor
+
+Thanks for taking the time to contribute!
+
+## Development Setup
+
+```bash
+git clone https://github.com/Sobranier/openclaw-doctor.git
+cd openclaw-doctor
+npm install
+```
+
+### Running locally
+
+```bash
+npm run dev -- status          # Quick health check
+npm run dev -- watch           # Foreground monitoring
+npm run dev -- watch -d        # Background daemon
+npm run dev -- unwatch         # Stop daemon
+```
+
+### Building
+
+```bash
+npm run build
+```
+
+Output goes to `dist/`.
+
+## Project Structure
+
+```
+src/
+  commands/      # CLI command handlers (watch, status, gateway, logs, ...)
+  core/          # Health check, restart logic, daemon management
+  dashboard/     # Web UI (Express + static assets)
+  notify/        # Notification channels (webhook, macOS system)
+  utils/         # OpenClaw config auto-detection, launchd helpers
+scripts/
+  publish.sh     # Multi-package publish script
+```
+
+## Making Changes
+
+1. Fork the repo and create a branch from `main`:
+   ```bash
+   git checkout -b fix/your-change
+   ```
+2. Make your changes and test locally with `npm run dev`.
+3. Build to make sure nothing is broken:
+   ```bash
+   npm run build
+   ```
+4. Open a Pull Request against `main`.
+
+## Release Workflow
+
+This repo publishes multiple npm packages from the same codebase. **Do not publish manually.**
+
+### Packages
+
+| Package | Config |
+|---------|--------|
+| `openclaw-doctor` | `package.json` |
+| `openclaw-cli` | `package.openclaw-cli.json` |
+| `openclaw-manage` | `package.openclaw-manage.json` |
+| _(and others)_ | `package.openclaw-*.json` |
+
+All packages share the same version number and `dist/` output.
+
+### Cutting a release
+
+```bash
+# 1. Pull latest
+git pull origin main
+
+# 2. Bump version (patch / minor / major)
+npm version patch   # e.g. 0.3.0 → 0.3.1
+
+# 3. Build + publish all packages
+npm run release
+```
+
+`npm run release` calls `scripts/publish.sh`, which:
+1. Builds once (`npm run build`)
+2. Publishes `openclaw-doctor` with `package.json`
+3. For each `package.openclaw-*.json`: temporarily swaps it in as `package.json`, publishes, then restores
+
+### Version sync
+
+All `package.openclaw-*.json` files must stay in sync with `package.json`. The publish script reads whichever `package.json` is active — keep `version` consistent across all of them.
+
+To update a sub-package metadata (description, keywords, bin), edit its `package.openclaw-*.json` directly.
+
+## Reporting Issues
+
+Open an issue on GitHub with:
+- Your OpenClaw version (`openclaw --version`)
+- Your OS and Node.js version
+- The output of `openclaw-doctor doctor`
+- What you expected vs. what happened
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](./LICENSE).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -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.md.bak

@@ -0,0 +1,242 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Sobranier/openclaw-doctor/main/assets/welcome.png" alt="OpenClaw Doctor" width="400" />
+</p>
+
+<h1 align="center">OpenClaw Doctor</h1>
+
+<p align="center">
+  Keep your OpenClaw service alive. Automatically.
+</p>
+
+<p align="center">
+  <a href="./README.zh-CN.md">中文文档</a>
+</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 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
+npm install -g openclaw-doctor
+openclaw-doctor watch -d
+```
+
+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
+
+```bash
+openclaw-doctor watch            # Start monitoring (foreground)
+openclaw-doctor watch -d         # Start monitoring (background)
+openclaw-doctor unwatch          # Stop monitoring
+
+openclaw-doctor status           # Quick health check
+```
+
+These four cover 90% of daily use.
+
+## Gateway Management
+
+```bash
+openclaw-doctor gateway start    # Start the OpenClaw gateway
+openclaw-doctor gateway stop     # Stop the gateway
+openclaw-doctor gateway restart  # Restart the gateway
+```
+
+## Diagnostics & Logs
+
+```bash
+openclaw-doctor doctor           # Full diagnostics (binary, gateway, channels)
+openclaw-doctor logs             # View gateway logs
+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
+
+```bash
+# npm (recommended)
+npm install -g openclaw-doctor
+
+# Run without installing
+npx openclaw-doctor status
+```
+
+> Requires Node.js >= 22 (same as OpenClaw).
+
+## How It Works
+
+Doctor auto-detects your OpenClaw installation — no manual config:
+
+- 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 |
+|---------|-------------|
+| `watch` | Start health monitoring (foreground) |
+| `watch -d` | Start health monitoring (background) |
+| `watch -d --dashboard` | Background monitoring + web dashboard |
+| `unwatch` | Stop monitoring |
+| `gateway start` | Start the OpenClaw gateway |
+| `gateway stop` | Stop the gateway |
+| `gateway restart` | Restart the gateway |
+| `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` | Error logs only |
+| `logs --doctor` | Doctor event logs |
+
+## Configuration
+
+Auto-created at `~/.openclaw-doctor/config.json` on first run.
+
+```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 | 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 covers the full restart lifecycle:
+
+| Event | Message |
+|-------|---------|
+| Started | "Doctor is watching your OpenClaw service" |
+| Degraded | "Service unhealthy (attempt 2/3)" |
+| Restarting | "Restarting gateway..." |
+| 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" |
+
+**Channels:** Webhook (DingTalk, Feishu, Slack, custom) + macOS system notifications.
+
+## Architecture
+
+```
+                          +-----------------+
+                          |  Notification   |
+                          |  (Webhook/OS)   |
+                          +--------^--------+
+                                   |
++-------------+    CLI    +--------+--------+    RPC      +-----------+
+|  OpenClaw   | --------> |                 | ---------> |  OpenClaw |
+|  / Scripts  |           | openclaw-doctor |            |  Gateway  |
+|  / Skills   | <-------- |  (daemon)       | <--------- | :18789    |
++-------------+  stdout   +--------+--------+  health    +-----------+
+                                   |
+                          +--------v--------+
+                          | ~/.openclaw/logs |
+                          | (read & analyze) |
+                          +-----------------+
+```
+
+Doctor runs as a standalone daemon. If the calling process crashes, Doctor keeps running.
+
+```bash
+openclaw-doctor status --json    # Machine-readable — pipe into scripts or agents
+openclaw-doctor watch -d         # Idempotent — safe to call repeatedly
+```
+
+## 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
+
+## Development
+
+```bash
+git clone https://github.com/Sobranier/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
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the release and publish workflow.
+
+## License
+
+[MIT](./LICENSE)
+
+---
+
+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).