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

npm install -g clawdoctor

Quick Start

# Interactive setup (Telegram bot token, chat ID, plan key)
clawdoctor init

# Start monitoring daemon
clawdoctor start

# Check health of all monitors
clawdoctor status

Commands

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