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