A proactive monitoring tool for tracking disk space and inode usage across system partitions to prevent downtime.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install disk-usage-watcher
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install disk-usage-watcher using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Disk Usage Watcher?
The Disk Usage Watcher is a vital utility within the Openclaw Skills ecosystem designed to maintain system health by providing real-time visibility into storage consumption. It automates the process of checking disk capacity and inode availability, ensuring that developers and system administrators are notified before storage exhaustion leads to application failure or data corruption.
By integrating directly into your AI agent workflows, this skill offers a seamless way to maintain server uptime through intelligent monitoring. Whether you are managing a single workstation or a fleet of servers, using Openclaw Skills like this one allows for consistent, programmable infrastructure oversight.
Disk Usage Watcher Use Cases
- Monitoring root partitions on production servers to prevent service interruptions.
- Automating cleanup tasks when disk usage exceeds specific thresholds like 85%.
- Tracking inode exhaustion in high-file-count environments like temporary directories or cache stores.
- Generating regular disk usage reports for infrastructure maintenance using Openclaw Skills.
How Disk Usage Watcher Works
- The skill executes system-level commands to gather current storage and inode statistics across specified or auto-detected mount points.
- It evaluates the collected data against user-defined thresholds for both space and inodes (defaulting to 85%).
- If any threshold is breached, the skill utilizes built-in dependencies to trigger an alert mechanism.
- The result is returned as a structured JSON object containing the status and detailed usage metrics for all monitored paths.
Disk Usage Watcher Setup
To use this skill, ensure you have the required dependencies (openclaw/exec and openclaw/notify) installed. You can test the functionality immediately by running the following command in your terminal:
openclaw call disk-usage-watcher --params '{"paths": ["/"]}'
Configuration involves setting your desired threshold_percent and identifying the specific paths you wish to monitor within your Openclaw Skills configuration.
Disk Usage Watcher Data Schema & Taxonomy
The skill returns a structured response that organizes storage data by mount point. The data schema includes:
| Field | Type | Description |
|---|---|---|
| status | String | Indicates "success" or "failure" of the check. |
| details | Object | Contains the main disk_usage array and alert triggers. |
| mount_point | String | The directory path being monitored (e.g., /var/log). |
| usage_pct | Number | The percentage of disk space currently in use. |
| inode_pct | Number | The percentage of inodes currently in use. |
| alerts | Array | A list of specific threshold violations found during the check. |
Disk Usage Watcher Advanced Features
- Automated cron execution every 15 minutes for hands-off system reliability and persistent monitoring.
- Customizable inode tracking to identify issues in file-heavy systems before they manifest as write errors.
- Multi-path monitoring allows for targeted oversight of specific partitions like /var/log, /home, or external volumes.
- Seamless integration with notification services within Openclaw Skills for instant mobile, email, or desktop alerts.
SKILL.md
Loading
Related Openclaw Skills
A/B Testing Framework
A high-performance framework for comparing and selecting the best LLMs through automated A/B testing and statistical analysis.
Safe Config Workflow
A secure automation workflow for modifying and validating OpenClaw configuration files with built-in recovery and learning loops.
Safe Config Workflow
An automated, fail-safe system for modifying Openclaw configuration files with built-in validation, repair, and learning feedback loops.
Safe Config Workflow
A professional framework for safely modifying Openclaw configuration files with automated validation, error recovery, and persistent learning.
Peloton Stats
A zero-dependency skill to fetch and report comprehensive Peloton cycling workout statistics and performance metrics.
Comms Hub Bridge
A high-performance communication layer for AI agents to exchange messages, files, and state information across a networked environment.
METADATA
Featured*
