SkillHub

turleydesigns-clawdoctor

v0.4.13

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`.

Sourced from ClawHub, Authored by RelayPlane

Installation

Please help me install the skill `turleydesigns-clawdoctor` from SkillHub official store. npx skills add RelayPlane/turleydesigns-clawdoctor

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