Server Health Agent

Server Health Agent is a production-ready OpenClaw skill designed to provide real-time monitoring of key server health metrics. It helps developers, DevOps engineers, and system administrators quickly assess the operational health of their VPS or server.

This skill executes safe system-level read-only commands to collect accurate health metrics without modifying the system.

Key Features

Real-Time CPU Monitoring

Uses live system commands (top) to capture current CPU utilization, with fallback mechanisms to ensure reliability even in restricted environments.

Memory (RAM) Monitoring

Reports accurate RAM usage percentage using system-level commands and Node.js fallback logic.

Disk Usage Monitoring

Provides root filesystem disk utilization, allowing detection of storage pressure or capacity issues.

Docker Container Detection

Detects and reports running Docker containers and their status when Docker socket access is available.

Gracefully handles environments where Docker access is restricted.

Structured Output

Returns structured JSON output optimized for OpenClaw automation workflows and downstream processing.

Use Cases

This skill is useful for:

VPS health monitoring
DevOps automation workflows
Infrastructure monitoring
Troubleshooting performance issues
Detecting resource bottlenecks
Monitoring containerized environments
Automated system health checks

Example Output

{
  "success": true,
  "skill": "server-health-agent",
  "timestamp": "2026-02-20T12:00:00Z",
  "server_health": {
    "cpu_percent": "12.44",
    "ram_percent": "21.33",
    "disk_usage": "51%",
    "docker_status": "openclaw-openclaw-gateway-1: Up 2 hours"
  }
}