本页内容

本页内容

平台概览

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 数组中。保留任何已存在的命令:

json5
{  gateway: {    nodes: {      commands: { allow: ["health.summary"] },    },  },}

health.summary 被归类为隐私密集型,iOS 平台默认不允许。 gateway.nodes.commands.deny 中的条目会覆盖允许条目。请参见节点命令策略。

2. 在 iOS 设备上启用共享

在 iOS 应用中:

  1. 打开 设置 -> 权限,并在始终可见的 Apple Health 部分中找到 Apple Health Summaries。
  2. 点击 启用 Apple Health Summaries。
  3. 阅读披露内容,然后选择OpenClaw可以在Apple的许可表中阅读哪些健康类别。

该开关会记录你为 OpenClaw 做出的明确共享选择。它并不表示 Apple 已授予所有请求的类别。

启用健康摘要会将 health.summary 添加到该节点声明的命令范围中。请批准随之产生的节点配对更新:

bash
openclaw nodes pendingopenclaw nodes approve <requestId>

然后验证已连接的 iOS 设备是否暴露了有效的 health.summary 命令:

bash
openclaw nodes describe --node "<iOS device name>"

请求今日摘要

仅支持 today。它涵盖本地午夜到请求时刻, 使用 iOS 设备当前的日历和时区。

bash
openclaw nodes invoke \  --node "<iOS device name>" \  --command health.summary \  --params '{"period":"today"}' \  --json

代理可以使用 nodes 工具调用相同的命令:

json
{  "action": "invoke",  "node": "<iOS device name>",  "invokeCommand": "health.summary",  "invokeParamsJson": "{\"period\":\"today\"}"}

摘要载荷包含:

字段 含义
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"}。不支持多日和历史摘要。

相关内容

本页有帮助吗?