A lightweight system health monitor that provides structured JSON reports on resource usage for predictive maintenance.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install system-vigil
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 system-vigil 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 System Vigil?
System Vigil is a specialized tool designed to provide AI agents with real-time insights into host machine health. By monitoring critical resource metrics such as Disk, Memory, and CPU usage, it empowers agents to identify potential bottlenecks or impending failures before they impact performance. This utility is an essential component of the Openclaw Skills ecosystem, ensuring that automated workflows are backed by robust system monitoring to prevent crashes caused by resource exhaustion.
System Vigil Use Cases
- Performing automated system health checks before executing resource-intensive tasks.
- Triggering alerts when disk or memory usage exceeds predefined safety thresholds.
- Integrating system status reporting into AI agent diagnostic and recovery workflows.
- Enabling predictive maintenance by monitoring long-term resource trends and load averages.
How System Vigil Works
- The AI agent invokes the internal Python script located within the skill directory.
- The script executes standard Linux utilities including df, free, and uptime to gather raw data.
- Raw command-line output is parsed and converted into a structured, machine-readable JSON format.
- The skill evaluates metrics against predefined thresholds to assign status flags such as ok, warning, or critical.
- The final JSON report is returned to the agent to inform subsequent logic or user notifications.
System Vigil Setup
To use this skill, ensure your host environment has the necessary Linux binaries installed. Most standard distributions include these by default.
# Ensure dependencies are available on Debian/Ubuntu
sudo apt-get update && sudo apt-get install coreutils procps
# The skill is called via the Openclaw Skills interface or directly via Python
python3 skills/system-vigil/check.py
System Vigil Data Schema & Taxonomy
The skill returns a structured JSON object detailing the health of the host machine:
| Field | Type | Description |
|---|---|---|
| status | string | The aggregate health state (ok, warning, critical) |
| disk | object | Contains used_percent (int) and free_gb (int) |
| memory | object | Contains used_percent (int) and free_gb (int) |
| cpu | object | Contains load_15m (float) representing the 15-minute load average |
System Vigil Advanced Features
- Predictive status flags that allow agents to pivot behavior based on resource availability.
- Native integration with Linux system utilities for high accuracy and low overhead.
- Structured JSON responses optimized for parsing by LLMs and other Openclaw Skills.
- Lightweight footprint suitable for both local development and remote server monitoring.
SKILL.md
Loading
Related Openclaw Skills
Sentinel Mood
A sentiment analysis tool for the Openclaw Skills library that uses NLTK VADER to detect emotional tone and urgency in text.
freeAPI
A local execution engine that allows Openclaw agents to connect directly to any API using standard OpenAPI specifications.
Agent Safehouse Client
A minimal, zero-dependency bash client for facilitating communication between AI agents via GitHub Issues.
NFT Artist Skill
An autonomous AI agent skill for generating, minting, and managing NFT art collections on the Base blockchain.
OKX CEX Market Data
A read-only CLI tool for accessing real-time OKX exchange market data including prices, candles, and order books without API credentials.
A-Stock Quantitative Monitor & Selector
A high-performance A-share quantitative system providing 7-dimension market sentiment scoring and 12-strategy intelligent stock selection.
Featured*
