🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Clawhub Skill Infra Watchdog
πŸ¦€ ClawHub

Clawhub Skill Infra Watchdog

by @mariusfit

Self-hosted infrastructure monitoring for HTTP, TCP, SSL, disk, memory, load, Docker, DNS, and custom commands with alerting via OpenClaw messaging.

Versionv1.1.0
Downloads2,373
#devops#legal
TERMINAL
clawhub install infra-watchdog

πŸ“– About This Skill

Infra Watchdog β€” Infrastructure Monitoring & Health Alerts

Self-hosted infrastructure monitoring for OpenClaw agents. Zero external SaaS required β€” monitors everything locally and alerts via WhatsApp, Telegram, or Discord.

What It Does

  • HTTP/HTTPS endpoint monitoring β€” checks status codes, response time, SSL validity
  • TCP port checks β€” database, SSH, custom services
  • Docker container status β€” running, stopped, unhealthy
  • System resources β€” CPU, RAM, disk usage with configurable thresholds
  • SSL certificate expiry β€” alerts 30 days before expiry
  • DNS resolution checks β€” verifies domain β†’ IP mappings
  • Proxmox VM/CT status β€” checks via local API
  • Alerts via WhatsApp/Telegram/Discord β€” with configurable cooldown

    • Quick Start

    # Initialize data directory & config
infra-watchdog init
    Add your first monitor
    
infra-watchdog add-monitor --type http --name "My API" --url https://myapi.example.com
    Add a TCP port check
    
infra-watchdog add-monitor --type tcp --name "PostgreSQL" --host localhost --port 5432
    Add a Docker container check
    
infra-watchdog add-monitor --type docker --name "My App" --container myapp
    Run all checks now
    
infra-watchdog check
    View current status dashboard
    
infra-watchdog dashboard
    Install auto-check cron (every 5 min)
    
infra-watchdog cron-install

    Commands

    | Command | Description | |---------|-------------| | infra-watchdog init | Set up data directory and default config | | infra-watchdog add-monitor | Add a new monitor (http/tcp/docker/resource/ssl/dns) | | infra-watchdog list | List all configured monitors and their current state | | infra-watchdog check | Run all checks immediately | | infra-watchdog check --name | Run a specific monitor | | infra-watchdog status | Summary: UP/DOWN/WARN counts | | infra-watchdog dashboard | ASCII dashboard with all monitors | | infra-watchdog cron-install | Install auto-check cron job |

    Monitor Types

    HTTP/HTTPS

    infra-watchdog add-monitor \
  --type http \
  --name "Main API" \
  --url https://api.example.com/health \
  --expected-status 200 \
  --timeout 5

    TCP Port

    infra-watchdog add-monitor \
  --type tcp \
  --name "Postgres" \
  --host 192.168.1.10 \
  --port 5432

    Docker Container

    infra-watchdog add-monitor \
  --type docker \
  --name "Nginx" \
  --container nginx-proxy

    System Resources

    infra-watchdog add-monitor \
  --type resource \
  --name "Disk /" \
  --resource disk \
  --path / \
  --warn-at 80 \
  --alert-at 90

    SSL Certificate

    infra-watchdog add-monitor \
  --type ssl \
  --name "My Domain SSL" \
  --host example.com \
  --port 443 \
  --warn-days 30

    Configuration

    Edit ~/.openclaw/workspace/infra-watchdog-data/config.json:

    {
  "alert_channel": "whatsapp",
  "alert_cooldown_minutes": 15,
  "check_interval_minutes": 5,
  "ssl_expiry_warning_days": 30
}

    Alert Channels

    | Channel | Config value | |---------|-------------| | WhatsApp | "whatsapp" | | Telegram | "telegram" | | Discord | "discord" | | None (log only) | "none" |

    Use Cases

    Homelab Monitoring

    Track all your self-hosted services: Proxmox, Docker stacks, databases, Jellyfin, Home Assistant, etc. Get a WhatsApp alert the moment anything goes down.

    API Uptime Monitoring

    If you sell API services on RapidAPI, this skill monitors your endpoints 24/7 and pings you before customers notice an outage.

    SSL Expiry Prevention

    Never let a certificate expire again. Get a WhatsApp warning 30 days before expiry.

    Resource Alerts

    Disk full at 3am? Get alerted before it kills your services.

    Data Storage

    All data stored locally at ~/.openclaw/workspace/infra-watchdog-data/. SQLite database, no cloud sync, no telemetry.

    Requirements

  • Python 3.8+
  • Docker (optional, for container monitoring)
  • OpenClaw 1.0+

    • Source & Issues

  • Source: https://github.com/mariusfit/infra-watchdog
  • Issues: https://github.com/mariusfit/infra-watchdog/issues
  • Author: @mariusfit

    • ⚑ When to Use

    TriggerAction
    Track all your self-hosted services: Proxmox, Docker stacks, databases, Jellyfin, Home Assistant, etc. Get a WhatsApp alert the moment anything goes down.
    ### API Uptime Monitoring
    If you sell API services on RapidAPI, this skill monitors your endpoints 24/7 and pings you before customers notice an outage.
    ### SSL Expiry Prevention
    Never let a certificate expire again. Get a WhatsApp warning 30 days before expiry.
    ### Resource Alerts
    Disk full at 3am? Get alerted before it kills your services.

    πŸ’‘ Examples

    # Initialize data directory & config
infra-watchdog init
    Add your first monitor
    
infra-watchdog add-monitor --type http --name "My API" --url https://myapi.example.com
    Add a TCP port check
    
infra-watchdog add-monitor --type tcp --name "PostgreSQL" --host localhost --port 5432
    Add a Docker container check
    
infra-watchdog add-monitor --type docker --name "My App" --container myapp
    Run all checks now
    
infra-watchdog check
    View current status dashboard
    
infra-watchdog dashboard
    Install auto-check cron (every 5 min)
    
infra-watchdog cron-install

    βš™οΈ Configuration

    Edit ~/.openclaw/workspace/infra-watchdog-data/config.json:

    {
  "alert_channel": "whatsapp",
  "alert_cooldown_minutes": 15,
  "check_interval_minutes": 5,
  "ssl_expiry_warning_days": 30
}