本页内容
本页内容
平台概览
HealthKit 摘要
HealthKit 摘要
OpenClaw 可以从连接的 iPhone 或 iPad 节点请求当前日历日的只读摘要。设备计算设备上的聚合数据,并仅返回步数、睡眠持续时间、平均静息心率和锻炼 count/duration. 不支持单独的 HealthKit 样本、来源、元数据、临床记录、后台摄取和写入。
此功能默认关闭。它需要在 iOS 设备上单独同意,并在 Gateway 上进行授权。
要求
- 一台运行 OpenClaw iOS 应用且 HealthKit 报告健康数据可用的 iPhone 或 iPad。
- 一个已连接并获批准的 iOS 节点。请参见 iOS 应用设置。
- 一个当前可到达 iOS 节点的 Gateway。
- 你期望看到的任何指标都需要有可读取的健康数据。Apple Watch 可以向 Apple Health 存储贡献数据,但 HealthKit 摘要不需要 OpenClaw watchOS 应用。
启用访问
1. 授权 Gateway 命令
将 health.summary 添加到 openclaw.json 中现有的 gateway.nodes.commands.allow 数组中。保留任何已存在的命令:
health.summary 被归类为隐私密集型,iOS 平台默认不允许。 gateway.nodes.commands.deny 中的条目会覆盖允许条目。请参见节点命令策略。
2. 在 iOS 设备上启用共享
在 iOS 应用中:
- 打开 设置 -> 权限,并在始终可见的 Apple Health 部分中找到 Apple Health Summaries。
- 点击 启用 Apple Health Summaries。
- 阅读披露内容,然后选择OpenClaw可以在Apple的许可表中阅读哪些健康类别。
该开关会记录你为 OpenClaw 做出的明确共享选择。它并不表示 Apple 已授予所有请求的类别。
启用健康摘要会将 health.summary 添加到该节点声明的命令范围中。请批准随之产生的节点配对更新:
然后验证已连接的 iOS 设备是否暴露了有效的 health.summary 命令:
请求今日摘要
仅支持 today。它涵盖本地午夜到请求时刻, 使用 iOS 设备当前的日历和时区。
代理可以使用 nodes 工具调用相同的命令:
摘要载荷包含:
| 字段 | 含义 |
|---|---|
period |
始终为 today |
startISO |
当地一天开始时间,编码为 ISO 时间点 |
endISO |
请求时间,编码为 ISO 时间点 |
timeZoneIdentifier |
iOS 设备时区标识符 |
stepCount |
四舍五入后的累计步数 |
sleepDurationMinutes |
去重后的睡眠时长,裁剪到今天 |
restingHeartRateBpm |
平均静息心率 |
workoutCount |
今日开始的锻炼次数 |
workoutDurationMinutes |
这些锻炼的总时长 |
指标字段是可选的;当 HealthKit 没有返回可读取的值时,会被省略。睡眠阶段和重叠来源会在计算时长之前合并,因此同一分钟不会被重复计数。
隐私行为
- 聚合发生在 iOS 设备上。原始样本不会离开设备。
- 请求的聚合会通过你的 Gateway 离开设备。当代理请求它时,聚合会到达已配置的 AI 提供方,并可能保留在聊天历史中。直接通过 CLI 调用则会将其返回给 CLI 操作员。
- OpenClaw 仅请求读取权限。它不能添加或修改 Health 数据。
- OpenClaw 仅在调用
health.summary时读取 HealthKit。不存在后台健康数据摄取。 - HealthKit 刻意不会透露读取权限是否被拒绝。缺少某项指标可能意味着拒绝访问、没有匹配的样本,或该数据类型不可用。OpenClaw 无法区分这些情况。
- 该摘要用于个人健康与健身背景信息,不是诊断或医疗建议。
要停止共享,请返回 Apple 健康摘要 并点击 关闭摘要。然后,iOS 设备从其节点表面删除运行状况功能和 health.summary 命令。您还可以从 gateway.nodes.commands.allow 中移除 health.summary 以关闭门的网关侧。
故障排查
该命令未由节点声明
确认 Apple 健康摘要已在 iOS 应用程序中启用并且设备已连接。运行 openclaw nodes pending 并批准任何功能更新,然后再次检查 openclaw nodes describe --node "<iOS device name>"。
该命令需要显式选择加入
将 health.summary 添加到 gateway.nodes.commands.allow。同时检查 gateway.nodes.commands.deny 中不包含它;拒绝列表优先生效。
HEALTH_ACCESS_DISABLED
应用端共享开关关闭。在 iOS 设备上的 设置 -> 权限 -> Apple Health 下启用 Apple Health Summaries。
摘要成功但缺少指标
打开 Apple 的 Health 应用,并确认今天存在数据。检查 OpenClaw 在 Apple 的 Health 设置中的访问权限,但不要将空结果视为已拒绝访问的证据:HealthKit 会刻意隐藏这种区别。
较早的时间范围失败
该命令仅接受 {"period":"today"}。不支持多日和历史摘要。