openclaw-utils 0.3.3 → 0.3.5

package/README.easyclaw.md

@@ -1,20 +1,25 @@
 # easyclaw
 
-> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+This package runs the same CLI engine as `openclaw-cli`.
 
-Install and run:
+## Install
 
 ```bash
 npm install -g easyclaw
-easyclaw watch -d
 ```
 
-This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+## Usage
+
+```bash
+easyclaw watch -d
+easyclaw status
+easyclaw gateway restart
+```
 
 ## Links
 
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
 - 📦 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)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.fastclaw.md

@@ -1,20 +1,25 @@
 # fastclaw
 
-> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+This package runs the same CLI engine as `openclaw-cli`.
 
-Install and run:
+## Install
 
 ```bash
 npm install -g fastclaw
-fastclaw watch -d
 ```
 
-This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+## Usage
+
+```bash
+fastclaw watch -d
+fastclaw status
+fastclaw gateway restart
+```
 
 ## Links
 
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
 - 📦 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)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.fbclaw.md

@@ -1,20 +1,25 @@
 # fbclaw
 
-> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+This package runs the same CLI engine as `openclaw-cli`.
 
-Install and run:
+## Install
 
 ```bash
 npm install -g fbclaw
-fbclaw watch -d
 ```
 
-This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+## Usage
+
+```bash
+fbclaw watch -d
+fbclaw status
+fbclaw gateway restart
+```
 
 ## Links
 
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
 - 📦 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)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.googleclaw.md

@@ -1,20 +1,25 @@
 # googleclaw
 
-> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+This package runs the same CLI engine as `openclaw-cli`.
 
-Install and run:
+## Install
 
 ```bash
 npm install -g googleclaw
-googleclaw watch -d
 ```
 
-This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+## Usage
+
+```bash
+googleclaw watch -d
+googleclaw status
+googleclaw gateway restart
+```
 
 ## Links
 
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
 - 📦 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)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.hello-claw.md

@@ -0,0 +1,25 @@
+# hello-claw
+
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
+
+This package runs the same CLI engine as `openclaw-cli`.
+
+## Install
+
+```bash
+npm install -g hello-claw
+```
+
+## Usage
+
+```bash
+hello-claw watch -d
+hello-claw status
+hello-claw gateway restart
+```
+
+## Links
+
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.hwclaw.md

@@ -1,20 +1,25 @@
 # hwclaw
 
-> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+This package runs the same CLI engine as `openclaw-cli`.
 
-Install and run:
+## Install
 
 ```bash
 npm install -g hwclaw
-hwclaw watch -d
 ```
 
-This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+## Usage
+
+```bash
+hwclaw watch -d
+hwclaw status
+hwclaw gateway restart
+```
 
 ## Links
 
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
 - 📦 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)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.jdclaw.md

@@ -1,20 +1,25 @@
 # jdclaw
 
-> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+This package runs the same CLI engine as `openclaw-cli`.
 
-Install and run:
+## Install
 
 ```bash
 npm install -g jdclaw
-jdclaw watch -d
 ```
 
-This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+## Usage
+
+```bash
+jdclaw watch -d
+jdclaw status
+jdclaw gateway restart
+```
 
 ## Links
 
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
 - 📦 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)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.kimiclaw.md

@@ -1,20 +1,25 @@
 # kimiclaw
 
-> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+This package runs the same CLI engine as `openclaw-cli`.
 
-Install and run:
+## Install
 
 ```bash
 npm install -g kimiclaw
-kimiclaw watch -d
 ```
 
-This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+## Usage
+
+```bash
+kimiclaw watch -d
+kimiclaw status
+kimiclaw gateway restart
+```
 
 ## Links
 
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
 - 📦 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)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.ksclaw.md

@@ -1,12 +1,25 @@
 # ksclaw
 
-> Alias for [openclaw-cli](https://www.npmjs.com/package/openclaw-cli).
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-Watchdog daemon for OpenClaw AI assistant gateway.
+This package runs the same CLI engine as `openclaw-cli`.
+
+## Install
 
 ```bash
 npm install -g ksclaw
+```
+
+## Usage
+
+```bash
 ksclaw watch -d
+ksclaw status
+ksclaw gateway restart
 ```
 
-See [openclaw-cli](https://github.com/Sobranier/openclaw-cli) for full docs.
+## Links
+
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.maxclaw.md

@@ -1,20 +1,25 @@
 # maxclaw
 
-> This is an alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)** — the AI assistant gateway watchdog.
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-## 🌐 Official Site: [https://openclaw-cli.app](https://openclaw-cli.app)
+This package runs the same CLI engine as `openclaw-cli`.
 
-Install and run:
+## Install
 
 ```bash
 npm install -g maxclaw
-maxclaw watch -d
 ```
 
-This package is identical to `openclaw-cli`. All features, docs, and updates are maintained there.
+## Usage
+
+```bash
+maxclaw watch -d
+maxclaw status
+maxclaw gateway restart
+```
 
 ## Links
 
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
 - 📦 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)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.md

@@ -1,239 +1,25 @@
-<p align="center">
-  <img src="https://raw.githubusercontent.com/Sobranier/openclaw-cli/main/assets/welcome.png" alt="OpenClaw utils" width="400" />
-</p>
+# openclaw-utils
 
-<h1 align="center">OpenClaw utils</h1>
+> Alias package for **[openclaw-cli](https://www.npmjs.com/package/openclaw-cli)**.
 
-<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)
-```
+This package runs the same CLI engine as `openclaw-cli`.
 
 ## 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
+## Usage
 
 ```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
+openclaw-utils watch -d
+openclaw-utils status
+openclaw-utils gateway restart
 ```
 
-`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
+## Links
 
-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.
+- 🌐 Official site: [https://openclaw-cli.app](https://openclaw-cli.app)
+- 📦 Main package: [openclaw-cli on npm](https://www.npmjs.com/package/openclaw-cli)
+- 📖 Source: [github.com/Sobranier/openclaw-cli](https://github.com/Sobranier/openclaw-cli)

package/README.md.bak

@@ -0,0 +1,75 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Sobranier/openclaw-cli/main/assets/welcome.png" alt="OpenClaw CLI" width="400" />
+</p>
+
+<h1 align="center">OpenClaw CLI</h1>
+
+<p align="center">
+  Keep your OpenClaw service alive. Automatically.
+</p>
+
+<p align="center">
+  <a href="./README.zh-CN.md">中文文档</a> | <a href="https://openclaw-cli.app">🌐 官网</a>
+</p>
+
+<p align="center">
+  <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="openclaw-cli" /></a>
+  &nbsp;
+  <a href="https://www.npmjs.com/package/openclaw-cli"><img src="https://img.shields.io/npm/dm/openclaw-cli?color=blue" alt="downloads" /></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-cli" alt="node" />
+</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.
+
+## Get Started
+
+```bash
+npm install -g openclaw-cli
+openclaw-cli watch -d
+```
+
+That's it. OpenClaw CLI is now running in the background.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Sobranier/openclaw-cli/main/assets/demo.gif" alt="OpenClaw CLI demo" width="700" />
+</p>
+
+## Core Commands
+
+```bash
+openclaw-cli watch            # Start monitoring (foreground)
+openclaw-cli watch -d         # Start monitoring (background)
+openclaw-cli unwatch          # Stop monitoring
+
+openclaw-cli status           # Quick health check
+openclaw-cli doctor           # Full diagnostics
+```
+
+## Gateway Management
+
+```bash
+openclaw-cli gateway start
+openclaw-cli gateway stop
+openclaw-cli gateway restart
+```
+
+## Compatibility Aliases
+
+`openclaw-doctor`, `hello-claw`, `aiclaw`, `pddclaw` and other alias package names all point to the same CLI engine.
+
+- Main package: https://www.npmjs.com/package/openclaw-cli
+- Official site: https://openclaw-cli.app
+
+## More Docs
+
+- Advanced usage and development workflow: [CONTRIBUTING.md](./CONTRIBUTING.md)
+- Chinese README: [README.zh-CN.md](./README.zh-CN.md)