π¦ ClawHub
Service Watchdog
by @mariusfit
Monitors self-hosted services by checking HTTP endpoints, TCP ports, SSL expiry, and DNS resolution, then reports status and alerts in concise, chat-friendly...
π‘ Examples
1. Create a watchlist
Create watchdog.json in your workspace root:
{
"services": [
{
"name": "Home Assistant",
"type": "http",
"url": "http://192.168.1.100:8123",
"expect_status": 200,
"timeout_ms": 5000
},
{
"name": "Proxmox",
"type": "https",
"url": "https://proxmox.local:8006",
"expect_status": 200,
"ssl_warn_days": 14,
"timeout_ms": 5000
},
{
"name": "PostgreSQL",
"type": "tcp",
"host": "db.local",
"port": 5432,
"timeout_ms": 3000
},
{
"name": "My Domain",
"type": "dns",
"domain": "example.com",
"expect_ip": "93.184.216.34"
}
],
"defaults": {
"timeout_ms": 5000,
"ssl_warn_days": 14,
"alert_cooldown_min": 30,
"history_retention_days": 30
}
}
2. Run a check
bash skills/service-watchdog/watchdog.sh
Output example:
π’ Home Assistant β 200 OK (142ms)
π’ Proxmox β 200 OK (89ms) | SSL: 47 days
π’ PostgreSQL β port 5432 open (12ms)
π’ My Domain β resolves to 93.184.216.34 β
ββββββββββββββββββββββββββββββββββ
4/4 healthy | avg response: 81ms | checked: 2026-02-24 16:30 UTC
3. Detailed report
bash skills/service-watchdog/watchdog.sh --report
Shows trend data: uptime percentage, P95 response times, incident history.
4. JSON output (for cron integration)
bash skills/service-watchdog/watchdog.sh --json
5. Check SSL only
bash skills/service-watchdog/watchdog.sh --ssl-only
6. Alert summary (for messaging)
bash skills/service-watchdog/watchdog.sh --alerts-only
Only outputs services that need attention (down, slow, SSL expiring).
TERMINAL
clawhub install service-watchdog