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#

MonitorWhat It WatchesIntervalGatewayWatcheropenclaw process running30sCronWatcher~/.openclaw/state/cron-*.json for missed/failed crons60sSessionWatcherAgent session files for errors, aborts, stuck sessions60sAuthWatcherGateway logs for 401/403/token expired patterns60sCostWatcherSession token costs — flags if >3x rolling average5m

What It Fixes#

HealerActionProcessHealerRestarts gateway via systemctl or openclaw gateway restart, then verifiesCronHealerLogs failure and includes manual rerun command in the alert

Pricing#

TierPriceMonitorsHistoryAuto-fixAlertsWatchFree57 days✗Local onlyDiagnose$9/mo2030 days✗✅ TelegramHeal$19/moUnlimited90 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):

text

🔴 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