Apple Health 同步

配套 iOS 应用：Health Sync for OpenClaw — 请从 App Store 下载安装，或侧载 IPA 文件。

配置（首次运行）

当用户提出“配置”、“连接 iPhone”或“配对手机”等请求时，请运行：

python3 {baseDir}/scripts/setup.py

该脚本将执行以下操作：

1. 自动读取您的 OpenClaw 网关 token
2. 检测当前机器可访问的 IP 地址（局域网或公网 IP）
3. 如需，自动以局域网模式启动网关
4. 在终端中打印一个 QR 码

请告知用户：

打开 Health Sync for OpenClaw App，点击「扫码自动配置」，扫描上方的 QR 码即可完成配置。

扫描成功后，App 即完成全部配置 — 无需手动输入 URL 或 token。

若终端中 QR 码过大无法显示完整

该脚本还会输出原始 JSON 内容。请告知用户可手动输入该 JSON，或使用 --compact 参数生成更小尺寸的 QR 码：

python3 {baseDir}/scripts/setup.py --compact

若 OpenClaw 部署在 VPS / 远程服务器上

脚本会自动识别运行环境为 VPS 还是本地，并自动选择合适的 IP。

若自动检测的 IP 不正确，或您已配置域名，请显式传入：

python3 {baseDir}/scripts/setup.py --host 

脚本还会检查端口 18789 是否可达；若不可达，则输出对应防火墙配置指引：

# Linux iptables
sudo iptables -A INPUT -p tcp --dport 18789 -j ACCEPT

# Ubuntu ufw
sudo ufw allow 18789/tcp

# Oracle Cloud：控制台 → 虚拟云网络（VCN）→ 安全列表 → 添加入站规则（TCP 18789）

自动触发：接收健康数据

当收到以 🍎 Apple Health 数据更新 开头的消息时，自动激活处理流程。

无需向用户确认 — 直接完成数据摄入并单行响应确认。

python3 {baseDir}/scripts/ingest.py << 'EOF'
[在此粘贴完整消息]
EOF

响应格式（仅限一行）：

✅ 已存储 N 条 [类型] 数据（时间）

用户健康查询

当用户询问步数、心率、睡眠、体重、HRV、卡路里、运动、SpO₂ 等相关数据时触发。

# 查询指定类型
python3 {baseDir}/scripts/query.py --type stepCount --period today

# 查询汇总信息
python3 {baseDir}/scripts/query.py --summary --period week

# 查询数据库状态
python3 {baseDir}/scripts/query.py --status

用户表述与 --type 参数映射关系如下：

查询结果请以自然、符合中文表达习惯的方式组织，严禁直接输出原始 JSON。

数据存储

所有数据均存于 ~/.apple-health-sync/health.db（SQLite 数据库，首次摄入数据时自动创建）。

规则

1. 对新到达的健康数据，先自动摄入，再单行确认 — 禁止弹出任何确认提示。
2. 禁止虚构数据 — 仅如实报告数据库中实际存在的内容。
3. 所有响应必须使用中文。
4. 严禁向用户暴露 bearer token。
5. 若配置失败，请原样输出具体错误信息，并建议使用 --host 参数指定自定义 IP。