- 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
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 clawdoctorQuick Start
# Interactive setup (Telegram bot token, chat ID, plan key)
clawdoctor init
# Start monitoring daemon
clawdoctor start
# Check health of all monitors
clawdoctor statusCommands
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 serviceWhat 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 foundNotes
- 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