A comprehensive macOS hardware health monitor for tracking CPU, RAM, disk space, and system temperatures via the command line.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macvital
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 macvital 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 macvital?
macvital is a powerful utility designed to provide instant visibility into the physical performance and health of macOS systems. As a key component of the Openclaw Skills ecosystem, it allows users and AI agents to programmatically assess if a machine is under heavy load, running at high temperatures, or facing memory constraints.
By leveraging Python-based scripts, macvital bridges the gap between complex system telemetry and actionable insights. It is particularly useful for developers who need to ensure their local environment has sufficient headroom before initiating resource-intensive builds or data processing tasks.
macvital Use Cases
- Assessing system readiness before launching heavy compilation or rendering tasks.
- Diagnosing performance bottlenecks by identifying top CPU and RAM-consuming processes.
- Monitoring disk space and memory pressure to prevent system instability.
- Checking thermal status on Apple Silicon to avoid hardware throttling.
- Automating system health checks within larger developer workflows using Openclaw Skills.
How macvital Works
- The skill executes a Python script that interfaces with macOS system utilities to gather real-time telemetry.
- It processes raw data for CPU usage, memory pressure, disk availability, and thermal sensors.
- The data is compared against predefined thresholds (Warn/Critical) to determine the system's health status.
- macvital returns the results in the requested format, such as a human-readable summary, a detailed breakdown, or a machine-readable JSON object.
- For automation, it provides specific exit codes (0 for OK, 1 for Warn, 2 for Critical) to trigger or halt subsequent agent actions.
macvital Setup
To integrate this into your Openclaw Skills library, ensure you have Python 3 installed and the script available in your path.
# Navigate to your skill directory
cd path/to/macvital
# Run a quick status check
python3 scripts/macvital.py status
# For accurate temperature readings on Apple Silicon
sudo python3 scripts/macvital.py temp
macvital Data Schema & Taxonomy
macvital organizes system telemetry based on specific hardware metrics and severity levels.
| Metric | Warn Threshold | Critical Threshold |
|---|---|---|
| CPU Usage | 70% | 90% |
| RAM Pressure | 75% | 90% |
| Disk Usage | 80% | 90% |
| Temperature | 80°C | 95°C |
Data can be exported via the --json flag for integration with other Openclaw Skills or external monitoring dashboards.
macvital Advanced Features
- Machine-readable JSON output for seamless integration with AI agent decision-making loops.
- Exit code signaling (0, 1, 2) specifically designed for shell scripting and automation pipelines.
- Watch mode with configurable intervals for continuous real-time system monitoring.
- Deep-dive process analysis to isolate specific resource hogs by PID and resource type.
SKILL.md
Loading
Related Openclaw Skills
Conference Schedule Optimizer
An AI-powered optimization tool designed to create personalized, high-impact itineraries for academic and scientific conferences.
TypeScript SDK: Types (Move ↔ TypeScript)
A specialized technical guide for mapping Aptos Move data types to TypeScript when using the @aptos-labs/ts-sdk.
OpenClaw Expert Brain
An interactive manual powered by NotebookLM with 185 curated sources providing expert-level guidance on the OpenClaw ecosystem.
YouTube Transcript (Captions-Only)
A specialized tool for extracting, formatting, and caching manual or auto-generated YouTube transcripts using yt-dlp.
ClawWars Arena
A browser-based spectator combat arena where AI agents engage in real-time tactical battles and challenge the Lobster King.
Shadow CSS Generator
A professional-grade CLI utility for generating, layering, and animating CSS shadows with local persistence.
Featured*
