← 返回 Skills 市场
lanyasheng

Apple Health CSV

作者 _silhouette · GitHub ↗ · v1.0.0
cross-platform ✓ 安全检测通过
349
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install apple-health-csv
功能描述
Query Apple Health data exported as CSV files from iOS apps like Simple Health Export or Health Auto Export. Supports 30+ health metrics including heart rate...
使用说明 (SKILL.md)

Apple Health CSV Skill

Query Apple Health data from CSV exports. Works with any iOS app that exports HealthKit data as CSV (Simple Health Export, Health Auto Export, etc.).

Setup

  1. Export health data from your iPhone using an app like Simple Health Export (free)
  2. Transfer the CSV files to your Mac (via AirDrop, iCloud, or USB)
  3. Place them in the skill data directory:
# Default location (auto-detected)
~/.openclaw/workspace-butler/health-data/

# Or specify a custom path
export HEALTH_DATA_DIR="/path/to/your/csv/files"

Usage

# List available health metrics
python3 scripts/health_query.py list

# Get a comprehensive daily health summary
python3 scripts/health_query.py summary

# Query a specific metric (last 7 days by default)
python3 scripts/health_query.py query HeartRate
python3 scripts/health_query.py query StepCount --days 14
python3 scripts/health_query.py query SleepAnalysis --days 7
python3 scripts/health_query.py query OxygenSaturation --days 30

# JSON output for programmatic use
python3 scripts/health_query.py query HeartRate --days 7 --json
python3 scripts/health_query.py summary --json

Supported Metrics

Category Metrics
Heart HeartRate, RestingHeartRate, WalkingHeartRateAverage, HeartRateVariabilitySDNN
Activity StepCount, ActiveEnergyBurned, BasalEnergyBurned, AppleExerciseTime, AppleStandTime, FlightsClimbed
Distance DistanceWalkingRunning, DistanceCycling, DistanceSwimming
Vitals OxygenSaturation, RespiratoryRate, BodyTemperature
Sleep SleepAnalysis (with stage breakdown: REM/Core/Deep/Awake)
Body BodyMass, BodyFatPercentage, BodyMassIndex, Height, LeanBodyMass
Walking WalkingSpeed, WalkingStepLength, WalkingAsymmetryPercentage, WalkingDoubleSupportPercentage
Audio EnvironmentalAudioExposure, HeadphoneAudioExposure
Performance VO2Max, SixMinuteWalkTestDistance, AppleWalkingSteadiness
Other DietaryWater, AppleSleepingWristTemperature

Tips for Agents

  1. Start with summary to get a quick overview of today's health
  2. Use --json flag when you need structured data for analysis
  3. Sleep data is grouped by night (cross-midnight sessions handled correctly)
  4. Blood oxygen values are auto-converted from 0-1 decimal to percentage
  5. Cumulative metrics (steps, calories, exercise time) show daily totals
  6. Rate metrics (heart rate, SpO2) show daily averages with min/max range
安全使用建议
This skill appears to do what it says: it reads Apple Health CSV exports from a local folder and produces summaries, with no network calls or secret requirements. Before installing: (1) Confirm where your CSVs must live — SKILL.md mentions ~/.openclaw/workspace-butler/health-data/ but the script defaults to a relative ../health-data; you can set HEALTH_DATA_DIR to point to your files. (2) Review the included scripts yourself (they are local Python code) if you want to be sure they only access the CSV folder. (3) Run the tool on a test CSV set first to confirm output and that it reads the intended files. If you need the agent to operate autonomously, remember this skill can be invoked by the agent but it does not request any special privileges or credentials.
功能分析
Type: OpenClaw Skill Name: apple-health-csv Version: 1.0.0 The apple-health-csv skill is a legitimate tool for analyzing local Apple Health CSV exports. The Python script (health_query.py) uses standard libraries to parse data, handles complex logic like cross-midnight sleep analysis, and contains no network-reaching code, obfuscation, or unauthorized file access. The instructions in SKILL.md are consistent with the code's functionality and do not contain prompt-injection attacks.
能力评估
ℹ Purpose & Capability
Name/description match the actual behavior: the code reads Apple Health CSV exports and computes summaries for many metrics. The SKILL.md says a default data directory of ~/.openclaw/workspace-butler/health-data/, but the script's DATA_DIR default is a relative ../health-data path (or set by HEALTH_DATA_DIR). This doc-vs-code mismatch could cause confusion for less technical users.
✓ Instruction Scope
Runtime instructions and the script keep operations local: reading CSV files from the stated data directory, parsing, grouping, and printing or emitting JSON. The instructions do not ask the agent to read arbitrary system files or transmit data externally.
✓ Install Mechanism
No install spec is present (instruction-only). The skill ships with a Python script and tests; nothing is downloaded or installed automatically, which minimizes install-time risk.
ℹ Credentials
The SKILL.md documents an optional HEALTH_DATA_DIR env var and the code honors an env var, so environment access is minimal and proportional. There are no required credentials or secrets. Note again the default path mismatch between docs and code.
✓ Persistence & Privilege
The skill is not always-enabled and does not request elevated or persistent platform privileges. It does not modify other skills or system-wide configuration.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install apple-health-csv
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /apple-health-csv 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release: local CSV-based Apple Health data query with 35+ metrics, sleep analysis, JSON output, 43 unit tests
元数据
Slug apple-health-csv
版本 1.0.0
许可证 —
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Apple Health CSV 是什么？

Query Apple Health data exported as CSV files from iOS apps like Simple Health Export or Health Auto Export. Supports 30+ health metrics including heart rate... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 349 次。

如何安装 Apple Health CSV？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install apple-health-csv」即可一键安装，无需额外配置。

Apple Health CSV 是免费的吗？

是的，Apple Health CSV 完全免费（开源免费），可自由下载、安装和使用。

Apple Health CSV 支持哪些平台？

Apple Health CSV 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Apple Health CSV？

由 _silhouette（@lanyasheng）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463368 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259467 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200457 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191163 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190189 · by oswalpalash

💬 留言讨论