Skill: relayplane/turleydesigns-clawdoctor (version 0.4.13)

--- name: clawdoctor description: Self-healing monitor for OpenClaw gateways, crons, and agent sessions. Use when you need to watch if OpenClaw is running, get Telegram alerts on failures, auto-restart the gateway, detect missed crons or stuck sessions, or monitor token costs. Install with `npm install -g clawdoctor`. metadata: { "openclaw": { "requires": { "bins": ["clawdoctor"] }, "install": [ { "id": "node", "kind": "node", "package": "clawdoctor", "bins": ["clawdoctor"], "label": "Install ClawDoctor (npm)", }, ], }, } --- # ClawDoctor Self-healing monitor for OpenClaw. Watches your gateway, crons, and agent sessions, sends Telegram alerts, and auto-fixes what it can. **Site:** https://clawdoctor.dev **npm:** https://www.npmjs.com/package/clawdoctor **GitHub:** https://github.com/turleydesigns/clawdoctor ## Install ```bash npm install -g clawdoctor ``` ## Quick Start ```bash # Interactive setup (Telegram bot token, chat ID, plan key) clawdoctor init # Start monitoring daemon clawdoctor start # Check health of all monitors clawdoctor status ``` ## Commands ```bash clawdoctor init # Interactive setup clawdoctor start # Start monitoring daemon clawdoctor start --dry-run # Run without taking healing actions clawdoctor stop # Stop daemon clawdoctor status # Live health check of all monitors clawdoctor log # Show recent events from local database clawdoctor log -n 100 # Show last 100 events clawdoctor log -w GatewayWatcher -s critical # Filter by watcher/severity clawdoctor install-service # Install as systemd user service ``` ## What It Monitors | Monitor | What It Watches | Interval | |---------|-----------------|----------| | **GatewayWatcher** | `openclaw` process running | 30s | | **CronWatcher** | `~/.openclaw/state/cron-*.json` for missed/failed crons | 60s | | **SessionWatcher** | Agent session files for errors, aborts, stuck sessions | 60s | | **AuthWatcher** | Gateway logs for 401/403/token expired patterns | 60s | | **CostWatcher** | Session token costs — flags if >3x rolling average | 5m | ## What It Fixes | Healer | Action | |--------|--------| | **ProcessHealer** | Restarts gateway via systemctl or `openclaw gateway restart`, then verifies | | **CronHealer** | Logs failure and includes manual rerun command in the alert | ## Pricing | Tier | Price | Monitors | History | Auto-fix | Alerts | |------|-------|----------|---------|----------|--------| | **Watch** | Free | 5 | 7 days | ✗ | Local only | | **Diagnose** | $9/mo | 20 | 30 days | ✗ | ✅ Telegram | | **Heal** | $19/mo | Unlimited | 90 days | ✅ | ✅ Telegram | - **Buy Diagnose ($9/mo):** https://buy.stripe.com/7sY14g2fsex33F08U51ck01 - **Buy Heal ($19/mo):** https://buy.stripe.com/eVq28k2fsdsZ7Vg6LX1ck02 ## Alerts Telegram alerts with rate limiting (max 1 per monitor per 5 minutes): ``` 🔴 ClawDoctor Alert Monitor: GatewayWatcher Severity: critical Message: openclaw process not found ``` ## Notes - Config stored at `~/.clawdoctor/config.json` - Events stored in SQLite at `~/.clawdoctor/events.db` - Free tier: 5 monitors, local alerts only, no auto-fix - Paid tiers activated via license key from https://clawdoctor.dev


Security scan verdicts — ClawScan: suspicious | static analysis: suspicious | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)