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