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
CODEBLOCK0
Manual
CODEBLOCK1
Quick start
For a one-shot snapshot, run:
CODEBLOCK2
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:
CODEBLOCK3
Raw JSON
For raw JSON, run:
CODEBLOCK4
Saved output or stdin
For saved macmon output or stdin, run:
CODEBLOCK5
Verify setup
Run:
CODEBLOCK6
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 - INLINECODE8 : normal active load
- INLINECODE9 : hot; mention sustained load or possible thermal pressure
- INLINECODE10 : memory pressure may be starting
- INLINECODE11 : 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.
Mac 健康检查
使用 macmon 作为实时 Mac 遥测数据的真实来源。
OpenClaw 的主机执行环境对于某些通过 Homebrew 安装的二进制文件来说可能过于精简。本技能包含一个位于 {baseDir}/bin/macmon-safe.sh 的封装脚本，可在必要时通过 zsh -lic 重试 macmon。
适用场景
- - 我的 Mac 当前温度是多少？
- 我的 Mac 温度如何？
- 给我做一次 Mac 健康检查
- 当前使用了多少内存和交换空间？
- 这台 Mac 当前是否处于负载状态？
- 显示这台 Mac 当前的 CPU 或 GPU 使用率
安装
通过 ClawHub
bash
clawhub install mac-health-check
手动安装
bash
git clone https://github.com/RuBAN-GT/mac-health-check-skill.git ~/.openclaw/skills/mac-health-check
快速开始
如需一次性快照，运行：
bash
python {baseDir}/scripts/macmon_status.py
默认的一次性模式使用 -i 200，以便更快返回第一个采样结果。
如果在你的 OpenClaw 设置中 macmon 仅能从登录 shell 中运行，你也可以直接使用封装脚本：
bash
bash {baseDir}/bin/macmon-safe.sh pipe -s 1
原始 JSON
如需原始 JSON，运行：
bash
python {baseDir}/scripts/macmon_status.py --format json --pretty
保存的输出或标准输入
如需使用保存的 macmon 输出或标准输入，运行：
bash
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 -
验证设置
运行：
bash
bash {baseDir}/bin/macmon-safe.sh pipe -s 1
如果输出一个 JSON 样本，则说明技能已准备就绪。
报告内容
默认摘要包括：
- - CPU 平均温度
- GPU 平均温度
- 性能核心 CPU 使用率和频率
- 能效核心 CPU 使用率和频率
- GPU 使用率和频率
- 系统、CPU 和 GPU 功耗
- 内存使用量
- 交换空间使用量
除非用户要求更深入的分析，否则保持解释简洁实用。
解读提示
- - CPU 温度低于 ~60C：通常表示空闲或轻度工作
- ~60C 到 85C：正常活动负载
- 85C+：高温；提示持续负载或可能存在热压力
- 交换空间使用量大于 0：内存压力可能开始出现
- 高系统功耗 + 高温：很可能处于持续工作状态
不要仅凭一次采样就过度断言存在风险。将其视为一次快照。
故障模式
- - 如果缺少 macmon，请直接说明。
- 如果已安装 macmon 但运行出错，请让用户手动运行 bash {baseDir}/bin/macmon-safe.sh pipe -s 1 并粘贴 JSON。
- 在某些 macOS 设置中，通过 Homebrew 安装的二进制文件仅能从登录 shell 中运行。在 OpenClaw 执行环境中，优先使用 bash {baseDir}/bin/macmon-safe.sh ...。
- 从文件或标准输入读取时，将最后一个非空行视为采样结果。
参考
当需要回顾 macmon 输出的常见 JSON 字段时，请参考 references/sample-output.md。
