Agent Defibrillator

Watchdog service that monitors your AI agent gateway and restarts it when it crashes.

What It Does

• Checks gateway health every 10 minutes
• Detects crashes and stale processes
• Auto-restarts with cooldown protection
• Optional Discord notifications on restart
• Detects version mismatches after updates

Install

Recommended (review code first):

git clone https://github.com/hazy2go/agent-defibrillator.git
cd agent-defibrillator
./install.sh

Verify

launchctl list | grep defib

Configure

Edit ~/.openclaw/scripts/defibrillator.sh:

Variable	Default	Description
DEFIB_GATEWAY_LABEL	ai.openclaw.gateway	launchd service label
DEFIB_RETRY_DELAY	10	Seconds between retries
DEFIB_MAX_RETRIES	3	Retries before restart
DEFIB_COOLDOWN	300	Seconds between restarts
DISCORD_CHANNEL	(empty)	Your channel ID for notifications

Commands

# View logs
tail -f ~/.openclaw/logs/defibrillator.log

# Manual check
~/.openclaw/scripts/defibrillator.sh

# Stop watchdog
launchctl bootout gui/$(id -u)/com.openclaw.defibrillator

# Restart watchdog
launchctl kickstart -k gui/$(id -u)/com.openclaw.defibrillator

Uninstall

launchctl bootout gui/$(id -u)/com.openclaw.defibrillator
rm ~/Library/LaunchAgents/com.openclaw.defibrillator.plist
rm ~/.openclaw/scripts/defibrillator.sh

Requirements

• macOS (uses launchd)
• AI agent running via launchd (OpenClaw, etc.)