OpenClaw Gateway Resilience Guard

Use this skill when a user wants to keep OpenClaw Gateway and message channels online after network drops, WSL sleep/resume, macOS/Windows wake events, or long-lived connection failures.

Install

Linux, WSL, or macOS:

bash install-watchdog.sh

The installer works with defaults. It prompts for the main channel probe URL when running interactively, but pressing Enter is enough for the default WeChat probe.

For unattended install:

bash install-watchdog.sh --yes

For a custom channel:

bash install-watchdog.sh --channel-url "https://your-channel.example.com/health"

Windows PowerShell:

powershell -ExecutionPolicy Bypass -File .\install-watchdog.ps1

Operate

systemctl --user status gateway-watchdog
journalctl --user -u gateway-watchdog -f
bash ~/.local/share/openclaw-gateway-watchdog/uninstall-watchdog.sh

On macOS, inspect launchctl print gui/$(id -u)/ai.clawhub.gateway-resilience-guard. On Windows, inspect Get-ScheduledTask -TaskName "OpenClaw Gateway Resilience Guard".

If user systemd is unavailable, the installer starts a direct background fallback and stores its pid under ~/.local/state/openclaw-gateway-watchdog/watchdog.pid.

Safety Model

The watchdog restarts only after layered checks:

1. OpenClaw native health probes: openclaw gateway status --require-rpc, openclaw health --json --verbose, and openclaw status --deep when available.
2. Local gateway health URL/TCP and main channel URL fallbacks.
3. General network URLs to avoid restarting during whole-machine network failure.
4. Backoff and hourly restart limits to avoid restart storms.

Tell users to review ~/.config/openclaw-gateway-watchdog/watchdog.env before publishing, sharing logs, or reporting issues.