gateway-watchdog

name	gateway-watchdog
description	Monitor OpenClaw Gateway health by tailing logs for error patterns — 429 rate limits, auth failures, delivery failures, timeouts. Alert when error rate crosses thresholds. Use when setting up production monitoring for an OpenClaw Gateway deployment, or when a user says "watch the gateway", "monitor gateway errors", "alert me on gateway failures".
metadata	{"emoji":"🛰️","category":"ops","platform":"any (OpenClaw)"}

Gateway Watchdog

Watch OpenClaw Gateway logs for error patterns and alert on threshold breaches. Designed to run as a cron job (every 5-15 min) or a long-lived tail process.

What It Catches

Pattern	Meaning	Default threshold
429 / rate_limit	API rate limiting	3 in 10 min → alert
401 / auth / unauthorized	Credential failure	1 → alert immediately
timeout / ECONNRESET	Network instability	5 in 10 min → alert
delivery_failed	Message send failure	1 → alert immediately
5xx upstream errors	Provider outage	3 in 5 min → alert

Configuration (env vars)

Variable	Default	Purpose
GATEWAY_LOG_PATH	~/.openclaw/logs/gateway.log	Log file to tail
WATCHDOG_STATE_DIR	~/.gateway-watchdog	Where state/cursor files live
WATCHDOG_WINDOW_MIN	10	Rolling window for thresholds
NOTIFY_TARGET	(empty)	Phone/JID to alert on breach
NOTIFY_CHANNEL	whatsapp	Notification channel

Usage

python3 scripts/watchdog.py

Cron every 5 minutes:

*/5 * * * * /usr/bin/python3 /path/to/gateway-watchdog/scripts/watchdog.py >> /tmp/gateway-watchdog.log 2>&1

Scripts

• scripts/watchdog.py — Incremental log scanner with cursor state. Counts patterns in rolling window, sends alert on threshold breach.