Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Gateway Watchdog
Monitor OpenClaw Gateway health by detecting abnormal error rates in logs. Use when: (1) setting up Gateway error monitoring, (2) diagnosing repeated API fai...
skill openclawclawhub Free
Monitor OpenClaw Gateway health by detecting abnormal error rates in logs. Use when: (1) setting up Gateway error monitoring, (2) diagnosing repeated API fai...
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, scripts/gateway-watchdog.sh
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.4.0
Provenance
- Publisher
- guoqunabc
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Gateway Watchdog
Detect abnormal error patterns in the OpenClaw Gateway before they cause damage. Works with all channels: Telegram, WhatsApp, Discord, Slack, Signal, iMessage, Feishu, and more. Born from a real incident: a silent try-catch caused 76,744 failed retries in 8 hours โ undetected until the API quota was exhausted.
What It Detects
CategoryPatternsRate limitingHTTP 429, rate.limit, too many requestsServer errorsHTTP 5xx status codesAuth/permissionHTTP 401/403, unauthorized, forbidden, token expiredNetwork errorsETIMEDOUT, ECONNREFUSED, ECONNRESET, ENOTFOUND, socket hang upDelivery failuressendMessage failed, deliver failed, fetch failedCustomUser-defined via WATCHDOG_EXTRA_PATTERNS env var
Smart Analysis
Error rate (errors/min) โ more meaningful than raw count Spike detection โ alerts when errors jump 3x+ vs last check Error concentration โ flags when 80%+ errors are one type (single fault source)
Quick Start
bash scripts/gateway-watchdog.sh check # silent unless errors exceed threshold bash scripts/gateway-watchdog.sh verbose # always outputs full report bash scripts/gateway-watchdog.sh history # show monitoring history bash scripts/gateway-watchdog.sh trend # last 24h error trend
Heartbeat integration
- Add to HEARTBEAT.md:
- ## Gateway Error Monitoring (every heartbeat)
- Run `~/.openclaw/workspace/skills/gateway-watchdog/scripts/gateway-watchdog.sh check`
- If output is non-empty, report to user immediately
- No output = healthy, skip reporting
Cron (optional)
openclaw cron add \ --name "gateway-watchdog" \ --schedule "*/30 * * * *" \ --task "Run gateway-watchdog.sh verbose. If errors detected, notify user with the report." \ --channel last
Configuration
All via environment variables: VariableDefaultDescriptionWATCHDOG_THRESHOLD30Error count that triggers alertWATCHDOG_WINDOW30Monitoring window in minutesWATCHDOG_SPIKE_RATIO3Alert when errors jump Nx vs last checkWATCHDOG_EXTRA_PATTERNS(empty)Custom regex patterns (e.g., 99991400|99991403)WATCHDOG_STATE~/.local/state/gateway-watchdog/state.jsonState fileWATCHDOG_LOG~/.local/state/gateway-watchdog/history.logHistory log
Adding channel-specific patterns
# Feishu-specific error codes export WATCHDOG_EXTRA_PATTERNS='99991400|99991403|99991404|99991429' # Telegram-specific export WATCHDOG_EXTRA_PATTERNS='Too Many Requests|FLOOD_WAIT|bot was blocked' # Discord-specific export WATCHDOG_EXTRA_PATTERNS='DiscordAPIError|Missing Permissions|Unknown Channel'
๐ด Alert (Chinese locale)
๐ด Gateway ๆ่ฟ 30 ๅ้ๅบ็ฐ 150 ๆกๅผๅธธ้่ฏฏ๏ผ้ๅผ: 30๏ผ5/min๏ผ ๐ ้่ฏฏ็ชๅข: 12 โ 150๏ผ3ๅ้ๅผ่งฆๅ๏ผ ้่ฏฏๅ็ฑป๏ผ 429/้ๆต: 120 5xxๆๅก็ซฏ้่ฏฏ: 5 ่ฎค่ฏ/ๆ้: 0 ็ฝ็ป้่ฏฏ: 5 ๆถๆฏๆ้ๅคฑ่ดฅ: 20 โ ๏ธ ๅไธ้่ฏฏ็ฑปๅใ429/้ๆตใๅ ๆฏ 80%๏ผๅฏ่ฝๆฏๅไธๆ ้ๆบ
๐ด Alert (English equivalent)
๐ด Gateway detected 150 errors in the last 30 min (threshold: 30, 5/min) ๐ Error spike: 12 โ 150 (3x threshold triggered) Error breakdown: 429/Rate-limit: 120 5xx Server errors: 5 Auth/Permission: 0 Network errors: 5 Delivery failures: 20 โ ๏ธ Single error type "429/Rate-limit" accounts for 80%+ โ likely a single fault source
๐ Healthy
No output from check mode.
Limitations
Requires systemd + journalctl (falls back to ~/.openclaw/logs/ on macOS) Reactive, not preventive Cannot pinpoint which extension is failing โ check error details for clues
Security
Read-only: Only reads logs No credentials: No API keys accessed No network: No outbound requests User state only: State in ~/.local/state/gateway-watchdog/ (XDG standard, no elevated permissions needed)
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs1 Scripts
- SKILL.md
- scripts/gateway-watchdog.sh