System Health Reporter

What This Skill Does

The System Health Reporter is a diagnostic utility designed for OpenClaw AI agents to provide instantaneous, actionable insights into a Linux server's operational status. It acts as an automated system administrator, gathering metrics from core Linux subsystems—CPU, memory, disk I/O, network listeners, and service health—to generate a consolidated markdown report. By parsing command-line output from standard tools like ps, free, and df, the agent translates raw data into a human-readable format featuring severity scoring (Healthy, Warning, Critical) and prioritized recommendations. It is strictly a read-only observability tool, ensuring no system state changes occur during diagnosis.

Installation

To install this skill, use the ClawHub command-line interface within your terminal: clawhub install openclaw/skills/skills/sa9saq/system-health-reporter

Ensure your environment has the necessary utilities installed, specifically the procps package, iproute2, and systemd for full functionality. The tool is designed to work out-of-the-box on most modern Ubuntu, Debian, RHEL, and Arch distributions.

Use Cases

1. Routine Server Maintenance: Automate daily or weekly check-ins to monitor resource utilization trends.
2. Troubleshooting Slow Performance: Quickly identify if system lag is caused by runaway processes, zombie threads, or high memory pressure.
3. Post-Incident Analysis: Generate an immediate snapshot of server state after a service outage to identify failed units or exhausted disk space.
4. Security Auditing: Review active network ports and login activity to ensure only expected services are reachable.

Example Prompts

1. "Run a full system health report and let me know if there are any immediate bottlenecks I should be worried about."
2. "Check the current memory and CPU usage. If anything is over 90%, please list the top 5 consumers."
3. "Generate a health report and save it to the ~/system-health-reports directory so I can review it later."

Tips & Limitations

• Permissions: While no root is required for basic metrics, some service-level details may provide deeper insights if the agent has sudo-level read access.
• Container Sensitivity: In Docker or LXC environments, CPU metrics may reflect the host hardware rather than the container limits. Always cross-reference with cgroups if necessary.
• Cross-Platform: The tool is optimized for Linux. While it includes logic for macOS, some features like systemd-specific checks are not applicable.
• Security Note: The report includes login history. When sharing these reports in public channels, ensure you redact usernames if privacy is a concern.