A comprehensive drive health monitoring and diagnostic suite that uses S.M.A.R.T. data to predict and report hardware failures.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install disk-guardian
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-guardian 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 Guardian?
Disk Guardian is a robust diagnostic utility designed for Openclaw Skills that provides deep visibility into your storage hardware. It automates the process of running S.M.A.R.T. (Self-Monitoring, Analysis, and Reporting Technology) tests across all connected drives, whether they are NVMe, SATA SSDs, or traditional HDDs. By parsing complex hardware attributes into human-readable health statuses, it empowers users to identify early failure patterns before catastrophic data loss occurs.
The tool is optimized for both macOS and Linux environments, offering a modular pipeline that can be used for one-off checks or integrated into automated system maintenance routines. It doesn't just show raw numbers; it interprets them, ranking drives by risk level and providing actionable recommendations based on historical trends and attribute severity.
Disk Guardian Use Cases
- Routine system maintenance to verify the integrity of all internal and external storage drives.
- Investigating system instability or slow file access that might indicate a failing disk.
- Proactive monitoring of server or homelab environments to receive alerts on rising reallocated sector counts.
- Comparing historical drive performance and temperature trends to identify cooling issues or wear-and-tear.
How Disk Guardian Works
- The scan_drives script detects all block devices and executes smartctl commands to gather raw hardware telemetry.
- The parse_smart script ingests the raw data to extract critical indicators like Power-On Hours, Reallocated Sectors, and NVMe Available Spare.
- Data is passed through a logic engine that assigns a health status (Good, Warning, or Critical) based on drive-specific thresholds.
- The history script optionally records the results to a local database to analyze long-term patterns and degradation trends.
- Finally, the report script generates a formatted Markdown summary, ranking drives by risk and offering specific maintenance recommendations.
Disk Guardian Setup
Ensure that smartmontools is installed on your system before using this Openclaw Skills entry.
# Install smartmontools
# macOS
brew install smartmontools
# Linux (Debian/Ubuntu)
sudo apt install smartmontools
# Navigate to the skill scripts
cd ~/.openclaw/workspace/skills/disk-guardian/scripts
# Run a basic health scan and generate a report
python3 scan_drives.py | python3 parse_smart.py | python3 report.py
Disk Guardian Data Schema & Taxonomy
Disk Guardian maintains a structured data hierarchy within the Openclaw Skills workspace for persistence and analysis.
| File/Directory | Purpose |
|---|---|
~/.openclaw/workspace/disk-guardian/history.json |
Stores time-stamped JSON logs of every scan performed. |
scripts/ |
Contains the Python logic for scanning, parsing, and reporting. |
references/smart-attributes.md |
A reference guide for interpreting specific SMART attribute IDs and thresholds. |
scan_results (JSON) |
Intermediate data format containing raw device output and OS metadata. |
Disk Guardian Advanced Features
- Trend Analysis: Detects concerning patterns over time, such as rapidly climbing temperatures or declining NVMe life percentages.
- Multi-Drive Ranking: Automatically ranks all system drives by a calculated risk score, factoring in both current errors and drive age.
- Automated Sudo Handling: Includes a --sudo flag for Linux environments where hardware-level access is restricted.
- Modular Pipeline: Each component functions as a standalone CLI tool, allowing developers to pipe data into external monitoring systems or custom dashboards.
SKILL.md
Loading
Related Openclaw Skills
Homelab Runbook
An automated scanning tool that generates comprehensive Markdown runbooks documenting Docker containers, system services, and open network ports.
Container Update Advisor
A sophisticated diagnostic tool that scans running Docker containers to identify newer image versions and generate prioritized update reports with changelog insights.
ISP Throttle Detective
A specialized tool for monitoring internet speeds across multiple endpoints to identify time-based or destination-based ISP throttling.
Test Runner
A versatile automated testing skill that detects, writes, and executes tests across various programming languages and frameworks.
Send To Me - WeChat Enterprise Messaging
A professional messaging utility for sending structured reports, alerts, and notifications directly to WeChat Enterprise (WeCom).
House Price Tracker
An AI-driven real estate tool for retrieving city-specific house prices, growth trends, and visual market reports.
Featured*
