✓ Verified 💻 Development ✓ Enhanced Data

Infra Watchdog

Self-hosted infrastructure monitoring for OpenClaw agents.

Rating
4.1 (500 reviews)
Downloads
4,423 downloads
Version
1.0.0

Overview

Self-hosted infrastructure monitoring for OpenClaw agents.

Key Features

1

HTTP/HTTPS endpoint monitoring — checks status codes, response time, SSL validity

2

TCP port checks — database, SSH, custom services

3

Docker container status — running, stopped, unhealthy

4

System resources — CPU, RAM, disk usage with configurable thresholds

5

SSL certificate expiry — alerts 30 days before expiry

6

DNS resolution checks — verifies domain → IP mappings

7

Proxmox VM/CT status — checks via local API

8

Alerts via WhatsApp/Telegram/Discord — with configurable cooldown

Complete Documentation

View Source →

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

bash
# 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

CommandDescription
infra-watchdog initSet up data directory and default config
infra-watchdog add-monitorAdd a new monitor (http/tcp/docker/resource/ssl/dns)
infra-watchdog listList all configured monitors and their current state
infra-watchdog checkRun all checks immediately
infra-watchdog check --name Run a specific monitor
infra-watchdog statusSummary: UP/DOWN/WARN counts
infra-watchdog dashboardASCII dashboard with all monitors
infra-watchdog cron-installInstall auto-check cron job

Monitor Types

HTTP/HTTPS

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

TCP Port

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

Docker Container

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

System Resources

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

SSL Certificate

bash
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:

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

Alert Channels

ChannelConfig 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

Installation

Terminal bash

openclaw install infra-watchdog
    
Copied!

💻Code Examples

infra-watchdog cron-install

infra-watchdog-cron-install.txt
## 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 <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

--warn-days 30

---warn-days-30.txt
## Configuration

Edit `~/.openclaw/workspace/infra-watchdog-data/config.json`:
example.sh
# 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
example.sh
infra-watchdog add-monitor \
  --type http \
  --name "Main API" \
  --url https://api.example.com/health \
  --expected-status 200 \
  --timeout 5
example.sh
infra-watchdog add-monitor \
  --type tcp \
  --name "Postgres" \
  --host 192.168.1.10 \
  --port 5432
example.sh
infra-watchdog add-monitor \
  --type docker \
  --name "Nginx" \
  --container nginx-proxy
example.sh
infra-watchdog add-monitor \
  --type resource \
  --name "Disk /" \
  --resource disk \
  --path / \
  --warn-at 80 \
  --alert-at 90
example.sh
infra-watchdog add-monitor \
  --type ssl \
  --name "My Domain SSL" \
  --host example.com \
  --port 443 \
  --warn-days 30
example.json
{
  "alert_channel": "whatsapp",
  "alert_cooldown_minutes": 15,
  "check_interval_minutes": 5,
  "ssl_expiry_warning_days": 30
}

Tags

#coding_agents-and-ides #monitoring

Quick Info

Category Development
Model Claude 3.5
Complexity Multi-Agent
Author mariusfit
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install infra-watchdog