mac-health-check（Mac 健康检查）

Mac Health Check

Use macmon as the source of truth for live Mac telemetry.

OpenClaw's host exec environment can be too minimal for some Homebrew-installed binaries. This skill includes a wrapper at {baseDir}/bin/macmon-safe.sh that retries macmon through zsh -lic when needed.

Use when

• "What's my Mac temperature right now?"
• "What's the temperature of my Mac?"
• "Give me a health check for this Mac"
• "How much RAM and swap is in use?"
• "Is this Mac under load right now?"
• "Show current CPU or GPU usage on this Mac"

Installation

Via ClawHub

clawhub install mac-health-check

Manual

git clone https://github.com/RuBAN-GT/mac-health-check-skill.git ~/.openclaw/skills/mac-health-check

Quick start

For a one-shot snapshot, run:

python {baseDir}/scripts/macmon_status.py

Default one-shot mode uses -i 200 so the first sample returns faster.

If macmon works only from a login shell in your OpenClaw setup, you can also use the wrapper directly:

bash {baseDir}/bin/macmon-safe.sh pipe -s 1

Raw JSON

For raw JSON, run:

python {baseDir}/scripts/macmon_status.py --format json --pretty

Saved output or stdin

For saved macmon output or stdin, run:

bash {baseDir}/bin/macmon-safe.sh pipe -s 1 > /tmp/macmon.jsonl
python {baseDir}/scripts/macmon_status.py --input /tmp/macmon.jsonl
cat /tmp/macmon.jsonl | python {baseDir}/scripts/macmon_status.py --input -

Verify setup

Run:

bash {baseDir}/bin/macmon-safe.sh pipe -s 1

If this prints a JSON sample, the skill is ready to use.

What to report

Default summary includes:

• CPU average temperature
• GPU average temperature
• Performance CPU usage and frequency
• Efficiency CPU usage and frequency
• GPU usage and frequency
• System, CPU, and GPU power
• RAM usage
• Swap usage

Keep the explanation practical and short unless the user asks for a deeper breakdown.

Interpretation hints

• CPU temp under ~60C: usually calm or light work
• ~60C to 85C: normal active load
• 85C+: hot; mention sustained load or possible thermal pressure
• swap usage above 0: memory pressure may be starting
• high system power + high temps: likely sustained work

Do not overclaim danger from one sample. Call it a snapshot.

Failure modes

• If macmon is missing, say so plainly.
• If macmon is installed but errors out, ask the user to run bash {baseDir}/bin/macmon-safe.sh pipe -s 1 manually and paste the JSON.
• On some macOS setups, Homebrew-installed binaries work only from a login shell. Prefer bash {baseDir}/bin/macmon-safe.sh ... in OpenClaw exec contexts.
• When reading from files or stdin, treat the last non-empty line as the sample.

Reference

Use references/sample-output.md when you need a reminder of the common JSON fields emitted by macmon.