System Monitor#

Real-time system health monitoring for the gateway host. Zero external dependencies.

Usage#

bash

# Full status report (human-readable)
python3 scripts/monitor.py

# JSON output (for programmatic use)
python3 scripts/monitor.py --json

# Check alert thresholds
python3 scripts/monitor.py --check-alerts

# Top N processes
python3 scripts/monitor.py --top 10

What It Reports#

MetricSourceCPU usage %/proc/statRAM used/total/available/proc/meminfoSwap used/total/proc/meminfoDisk usage per mountdf -hCPU temperature/sys/class/thermal/thermal_zone0/tempUptime/proc/uptimeLoad average (1/5/15m)/proc/loadavgTop processes by CPUps aux

Alert Thresholds#

Default (configurable in SKILL.md or via code):

AlertThresholdRAM> 90% usedSwap> 500MB usedCPU temp> 75°CDisk> 90% full

Security#

• Read-only: Never writes, modifies, or executes anything beyond reading system stats
• No network access: Purely local /proc, /sys, ps, df
• No secrets: Does not access config files, tokens, or credentials
• Safe in groups: Output contains no sensitive paths, tokens, or user data

Automation#

Use with cron for periodic health checks:

bash

# Every 30 minutes via OpenClaw cron → alerts to Telegram
# Or via HEARTBEAT.md