Agent Defibrillator

---

name: agent-defibrillator description: Watchdog that monitors your AI agent gateway and restarts it when it crashes. Triggers on "install defibrillator", "agent watchdog", "gateway monitor", "auto-restart agent", or "keep agent alive". macOS launchd service with optional Discord notifications.

---

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