server-health

What This Skill Does

The server-health skill is a powerful diagnostic tool designed for OpenClaw agents to provide real-time observability into the underlying infrastructure of your system. It serves as a centralized dashboard that synthesizes complex system data—such as CPU load, memory utilization, and disk pressure—into a human-readable format. Beyond standard system metrics, the tool uniquely integrates OpenClaw gateway status and specific configuration monitoring, allowing users to verify the health of their AI agent pipelines alongside the hardware they reside on. Whether you are running a local development environment or a production server, this skill offers an essential snapshot of performance, ensuring that your system resources are allocated efficiently and that critical services like Docker or PostgreSQL are operational.

Installation

To integrate this monitoring capability into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/muslimalfatih/server-health

Ensure that you have the appropriate permissions on the target machine to allow the agent to query system stats and process information.

Use Cases

This skill is perfect for automated infrastructure maintenance and manual health checks. Developers can utilize the --json output flag to pipe server status into automated alerting pipelines (e.g., Slack or Discord bots), while administrators can use the --verbose flag for deep-dive troubleshooting during performance spikes. It is an ideal companion for remote server management via Telegram, where quick insights prevent downtime by notifying you of high CPU or memory thresholds before they cascade into service failures.

Example Prompts

1. "Check the current system health and confirm the status of the OpenClaw gateway."
2. "Run a server health check and output the data in JSON format for my monitoring script."
3. "Is the server overloaded? Show me the top processes and any current alerts."

Tips & Limitations

For optimal results, run the skill with sufficient privileges to view all processes. Note that the temperature and specific hardware monitoring features may vary based on your Linux distribution's sensor support. If you are tracking service status for custom containers or non-standard databases, ensure that the monitoring user has read access to those system sockets. Always use the --alerts flag in automated cron jobs to minimize noise and focus only on actionable system warnings.