Clawdoctor

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.

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):

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