Clawstats

What This Skill Does

Clawstats is a powerful system monitoring utility designed specifically for OpenClaw agents, providing a unified interface to inspect server health and performance metrics. By leveraging standard Unix-like utilities such as 'free', 'df', 'top', and 'ps', it aggregates complex system data into clear, readable outputs. It is an essential tool for agents managing autonomous deployments, allowing them to proactively identify bottlenecks, monitor disk capacity to prevent system halts, and detect runaway processes that might affect agent responsiveness.

Installation

Installation is straightforward and designed for standard Linux environments. First, ensure your OpenClaw agent has the necessary binaries installed. The skill is installed by placing the repository contents into your workspace skills directory: ~/.openclaw/workspace/skills/clawstats. Once cloned, grant execution permissions to the script using chmod +x monitor.sh. To unlock the full potential of the skill, specifically temperature reporting, ensure that lm-sensors is installed on your host machine. If you are using an official OpenClaw environment, you can use the command: clawhub install openclaw/skills/skills/aprilox/clawstats.

Use Cases

This skill is perfect for infrastructure management. Use it to audit resource consumption across a fleet of agents, verify that your server has enough disk space before executing large file-management tasks, or troubleshoot sudden latency spikes by checking the current 'top' processes. It provides developers and autonomous agents the visibility required to make informed decisions about resource allocation and system stability.

Example Prompts

1. "Check the current system status using clawstats and let me know if memory usage is exceeding 80 percent."
2. "Run a full health check. I need to see the top 5 resource-heavy processes running on the server right now."
3. "Is there enough disk space on the root partition to initiate the large backup task? Check with clawstats."

Tips & Limitations

To get the most out of Clawstats, always ensure your agent has proper read permissions for system metrics. For best results on headless servers, consider using 'all' mode to capture a holistic snapshot. Note that the temperature tracking functionality relies on local thermal zone support; if your specific cloud provider or container environment restricts access to hardware sensors, the temperature output may be unavailable or report null values. Always monitor logs if you experience discrepancies in process reporting.