核心用法
Apple Health Sync 是一套面向 iOS 用户的隐私优先型健康数据同步方案，通过端到端加密机制将 Apple Health 数据安全迁移至 OpenClaw 智能体本地环境。完整工作流包含四大环节：初始化密钥对与二维码生成、加密数据拉取与解密、卫生化持久化存储、以及周期性报告生成。
初始化阶段 由 bootstrap_skill.py 主导，自动生成 RSA 密钥对、用户标识与写入令牌，并输出可供 iPhone 扫码的 QR 码，完成 iOS 端 Health Sync for OpenClaw App 的配对配置。
数据同步阶段 通过 fetch_health_data.py 执行挑战-响应认证，从中继服务获取加密载荷，本地解密后经严格 fail-closed 卫生化处理，默认写入 SQLite 的 health_data 表。支持手动触发或 OpenClaw CronJob 自动化调度。
报告生成阶段 由 create_health_report.py 实现，可按日/周/月聚合本地快照，输出文本或 JSON 格式，支持指定落盘路径。
显著优点
- 端到端加密：私钥永不离本地，中继仅传输密文，从源头杜绝中间人窥探
- 隐私优先设计：数据卫生化（sanitization）与 fail-closed 策略，异常数据自动丢弃
- Apple 官方生态兼容：直接对接 iOS HealthKit，无需越狱或私有 API
- 自动化就绪：原生支持 OpenClaw CronJobs，可无人值守运行
- 离线优先：解密与报告均在本地完成，无需持续云端连接
潜在缺点与局限性
- 单点密钥风险：若
private_key.pem丢失且未备份，历史数据永久不可解密 - iOS 生态锁定：必须使用指定 App Store 应用，无 Android 替代方案
- 中继依赖：加密数据获取依赖外部中继服务，若服务不可用则同步中断
- 存储模式单一：强制固定至
~/.apple-health-sync，不可自定义路径 - 功能范围受限：专注原始数据同步与基础聚合，不含医学级分析或诊断建议
适合人群
- 注重隐私的 Apple Health 重度用户
- 希望自建健康数据仓库、拒绝云端厂商锁定的技术爱好者
- 需要将健康数据接入 OpenClaw 自动化工作流的高级用户
- 对数据主权有合规要求的个人或小型团队
常规风险
- 密钥泄露：
private_key.pem一旦外泄，攻击者可解密全部历史数据 - iOS App 供应链：依赖第三方 App Store 应用，需信任其代码审计与更新策略
- 中继服务可用性：无公开 SLA 保障，存在服务中断导致同步延迟的风险
- 数据完整性：卫生化规则过于严格可能导致边缘场景数据丢失
- CronJob 配置误用：若绕过 OpenClaw CronJobs 使用系统 cron，可能引发权限或环境隔离问题