← 返回 Skills 市场
Mac System Stat
作者
Zhang Xiaofeng
· GitHub ↗
· v1.0.1
· MIT-0
341
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install mac-system-stat
功能描述
Generate a concise macOS host resource report focused on local-model readiness and machine pressure. Use when the user asks about Mac resource usage, current...
使用说明 (SKILL.md)
mac-system-stat
Produce a concise macOS host snapshot using small local helpers.
Use when
- The user asks for current Mac resource usage or machine health
- You need CPU, memory, GPU, swap, power, fan, or a short host summary
- You want a truthful one-shot report, not continuous monitoring
Scripts
scripts/hoststat— aggregate JSON host snapshotscripts/memstat— RAM / compression / swap / memory pressurescripts/cpustat— CPU usage, load average, process counts, top CPU processesscripts/gpustat— GPU model + live IOAccelerator statistics via local Swift/IOKit helperscripts/powerstat— Apple Silicon IOReport-based power sampler (non-privileged, short window average)scripts/fanstat— AppleSMC-based fan reader (fan count, RPM, min/max, mode)scripts/tempstat— AppleSMC temperature sensors + pmset thermal state (CPU, battery, ambient, board)scripts/build-helpers— prebuild Swift helpers explicitly (optional; normal wrappers auto-build as needed)
Layout
- The skill is intentionally self-contained under
skills/mac-system-stat/ - Python entrypoints, shared Python modules, Swift sources, and compiled helper output all live under
skills/mac-system-stat/scripts/ scripts/bin/is generated locally on first run or viascripts/build-helpers
Release contract
- Chosen contract: source-only, self-building on first run
- Ship the skill directory with Python + Swift sources; do not rely on compiled helpers being pre-vendored
gpustat,powerstat,fanstat, andtempstatwill auto-build their helper binaries intoscripts/bin/when missing or stale- If
swiftc/ Apple Command Line Tools are unavailable, those four helpers fail truthfully with structured JSON;memstatandcpustatstill run normally - For packaging / ClawHub, exclude transient local artifacts such as
scripts/bin/contents and__pycache__/
Notes
- macOS only; Apple Silicon first
- Default path avoids sudo
- Prefer helper JSON over hand-written summaries
- GPU reads IORegistry properties directly via IOKit instead of parsing
ioregtext - Power uses IOReport Energy Model deltas; values are short-window averages, not hardware-meter absolutes
- Fan RPM comes from AppleSMC F* keys; 0 RPM can mean the fans are currently stopped
- Temperature uses curated AppleSMC keys (Tp0P, Tp0T, Te0T, Ts0P, TB0T, TW0P, Ta0P) + pmset therm state
- Packaging caveat: compiled helpers are not vendored; the target machine still needs Command Line Tools /
swiftcfor first build unless prebuilt binaries are shipped separately
安全使用建议
This skill appears to do exactly what it says: compile and run local helpers to produce a macOS system snapshot. Before installing, consider: (1) the skill compiles and executes native Swift binaries on your machine using your system's swiftc/Xcode Command Line Tools — review the included Swift sources if you don't fully trust the publisher; (2) the helpers access low-level APIs (IOKit/AppleSMC/IOReport) to read hardware sensors — they run with your user privileges and can read hardware state, but do not perform network exfiltration or request credentials; (3) the skill writes build artifacts to scripts/bin/ within its folder; you may want to run it in a controlled environment or inspect the code prior to first run if you need stronger assurance.
功能分析
Type: OpenClaw Skill
Name: mac-system-stat
Version: 1.0.1
The skill `mac-system-stat` provides macOS system telemetry by aggregating data from Python scripts and Swift-based helpers. It employs high-risk capabilities, specifically the automated compilation of Swift source code (`scripts/build-swift-helpers.sh`) and the use of `shell=True` for command execution in `_common.py`. Additionally, it interfaces with low-level and private macOS APIs (`IOKit`, `AppleSMC`, `IOReport`) to access hardware-level statistics. While these behaviors are aligned with the stated purpose of system monitoring and no evidence of malicious intent or exfiltration was found, the reliance on on-the-fly compilation and shell-based execution poses an inherent security risk.
能力评估
Purpose & Capability
Name/description claim a macOS resource snapshot; the code and runtime instructions only access local system commands (top, ps, vm_stat, system_profiler, sysctl, memory_pressure) and local Swift IOKit/AppleSMC/IOReport helpers — all appropriate for the stated purpose.
Instruction Scope
SKILL.md directs the agent to build and run local Python and Swift helpers that read hardware/OS state. This is within scope, but the helpers compile native binaries and use IOKit/AppleSMC/IOReport (low-level hardware APIs). There are no network calls or attempts to read unrelated credential/config files.
Install Mechanism
No external download/install spec. The skill is source-only and self-builds Swift helpers locally using the system swiftc (Apple Command Line Tools). Built binaries are placed under scripts/bin/ in the skill directory. No remote URLs or package registry pulls are used.
Credentials
The skill requests no environment variables, no credentials, and no config paths. All accessed data are local system interfaces appropriate for a system-status tool.
Persistence & Privilege
always:false (normal). The skill will create compiled helper binaries under its own scripts/bin/ on first run — this writes files to the skill directory but does not modify other skills or global agent config. Helpers run with the invoking user's privileges.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install mac-system-stat - 安装完成后，直接呼叫该 Skill 的名称或使用
/mac-system-stat触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
fix: remove unreliable Ta0P ambient temp sensor on M4 Max
v1.0.0
Initial release: CPU, memory, GPU utilization, power draw, fan RPM, temperature sensors for macOS Apple Silicon
元数据
常见问题
Mac System Stat 是什么？
Generate a concise macOS host resource report focused on local-model readiness and machine pressure. Use when the user asks about Mac resource usage, current... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 341 次。
如何安装 Mac System Stat？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install mac-system-stat」即可一键安装，无需额外配置。
Mac System Stat 是免费的吗？
是的，Mac System Stat 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Mac System Stat 支持哪些平台？
Mac System Stat 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Mac System Stat？
由 Zhang Xiaofeng（@tomcatzh）开发并维护，当前版本 v1.0.1。
推荐 Skills