← 返回 Skills 市场
158
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install macvital
功能描述
Check macOS hardware health: CPU usage, RAM pressure, disk space, temperatures, and top processes. Returns a quick status summary or full breakdown. USE WHEN...
使用说明 (SKILL.md)
macvital
macOS hardware health monitor. Checks CPU, RAM, disk, temperature, and top resource hogs.
Requirements
- Python 3 (pre-installed on macOS)
- Script:
scripts/macvital.py - Temperature data requires
sudo(Apple Silicon only)
Commands
# Quick one-line status (good/warn/critical with icons)
python3 scripts/macvital.py status
python3 scripts/macvital.py status --json # machine-readable
# Full breakdown
python3 scripts/macvital.py detail
# Top CPU and RAM processes
python3 scripts/macvital.py top
python3 scripts/macvital.py top --n 10
# Temperature only (more accurate with sudo)
python3 scripts/macvital.py temp
sudo python3 scripts/macvital.py temp
# Exit code check (for scripting: 0=ok, 1=warn, 2=critical)
python3 scripts/macvital.py check
# Continuous monitoring
python3 scripts/macvital.py watch
python3 scripts/macvital.py watch --interval 10
Thresholds
| Metric | Warn | Critical |
|---|---|---|
| CPU | 70% | 90% |
| RAM | 75% | 90% |
| Disk | 80% | 90% |
| Temp | 80°C | 95°C |
Typical Use (agent workflow)
# Before a heavy task
python3 scripts/macvital.py check
# exit 0 = safe to proceed, exit 1/2 = consider waiting
# Quick heartbeat line
python3 scripts/macvital.py status
# Diagnosing slowness
python3 scripts/macvital.py detail
python3 scripts/macvital.py top
安全使用建议
This skill appears to do exactly what it claims: local macOS health checks using standard system commands, with no network calls or credential access. Things to consider before installing: (1) the script may require sudo to show die temperatures — it will prompt for a password if run interactively; (2) the code uses subprocess for shell commands (some with shell=True). That is fine for fixed commands, but avoid passing untrusted input into CLI args to prevent injection; the author-supplied CLI appears safe, but be cautious if you plan to call the script programmatically with user-supplied strings. (3) There is a minor bug in RAM percentage calculation that may produce incorrect RAM% — treat numeric thresholds with caution. (4) The skill has no homepage and an unknown owner; if you will rely on it long-term, consider auditing the full file (scripts/macvital.py) locally or running it in a controlled environment first. Otherwise it is coherent and proportionate for its purpose.
功能分析
Type: OpenClaw Skill
Name: macvital
Version: 1.0.1
The macvital skill is a macOS system health monitor that provides CPU, RAM, disk, and temperature metrics using standard system utilities like top, vm_stat, and powermetrics. While the get_disk function in scripts/macvital.py contains a potential shell injection vulnerability because it passes a path string directly to a shell-enabled subprocess call, this functionality is not exposed to user input via the command-line interface. The skill's behavior aligns perfectly with its documentation and lacks any indicators of malicious intent, data exfiltration, or persistence.
能力评估
Purpose & Capability
Name/description match behavior: the script runs macOS system utilities (top, vm_stat, sysctl, df, ioreg, powermetrics, ps) to collect CPU, RAM, disk, temperature, and process info. There are no unrelated binaries, env vars, or external services required.
Instruction Scope
SKILL.md instructs only to run the bundled script and documents the commands. The script only executes local system commands and prints results. Note: the script calls 'sudo powermetrics' for die temps (documented) and uses subprocess with shell=True for some fixed command strings; if callers pass untrusted input into those string commands (e.g., arbitrary text injected into the 'n' parameter), shell injection risk could arise. Also there is a bug in RAM percentage math (used_pct calculation multiplies by 1024**3 unnecessarily) that may misreport RAM percent.
Install Mechanism
No install spec; skill is instruction + script only. Nothing is downloaded or written to disk by an installer step.
Credentials
No environment variables, credentials, or config paths are requested. The optional need for sudo to read die temperatures is reasonable and documented.
Persistence & Privilege
Skill is not always-enabled and does not request persistent presence or modify other skills/system settings. It runs ad-hoc when invoked.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install macvital - 安装完成后，直接呼叫该 Skill 的名称或使用
/macvital触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
macvital 1.0.1
- Internal update: scripts/macvital.py modified.
- No user-facing changes documented.
v1.0.0
Initial release of macvital – macOS hardware health monitor.
- Provides quick status summaries or detailed breakdowns of CPU, RAM, disk, and temperature usage.
- Shows top processes by CPU or RAM usage.
- Offers thresholds for warning/critical states for all key metrics.
- Supports both human-friendly and machine-readable outputs.
- Includes commands for single checks, continuous monitoring, and workflow integration before heavy tasks.
元数据
常见问题
Macvital 是什么？
Check macOS hardware health: CPU usage, RAM pressure, disk space, temperatures, and top processes. Returns a quick status summary or full breakdown. USE WHEN... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 158 次。
如何安装 Macvital？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install macvital」即可一键安装，无需额外配置。
Macvital 是免费的吗？
是的，Macvital 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Macvital 支持哪些平台？
Macvital 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Macvital？
由 wrentheai（@wrentheai）开发并维护，当前版本 v1.0.1。
推荐 Skills