HealthKit summaries

HealthKit summaries 문서는 OpenClaw 공식 문서(platforms/ios-healthkit)를 한국어로 정리한 가이드입니다. Enable and invoke privacy-gated HealthKit summaries from an iOS node 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Enable and invoke privacy-gated HealthKit summaries from an iOS node

한국어 가이드 범위: platforms/ios-healthkit 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

HealthKit summaries
요구사항
Enable access
1. Authorize the Gateway command
2. Enable sharing on the iOS device
Request today's summary
Privacy behavior
트러블슈팅
Command is not declared by the node
Command requires explicit opt-in
HEALTH_ACCESS_DISABLED
Summary succeeds but metrics are missing
Older ranges fail
관련 문서

상세 내용

HealthKit summaries

OpenClaw can request a read-only summary of the current calendar day from a connected iPhone or iPad node. The device computes the aggregate on-device and returns only steps, sleep duration, average resting heart rate, and workout count/duration. Individual HealthKit samples, sources, metadata, clinical records, background ingestion, and writes are not supported.

요구사항

contribute data to the Apple Health store, but the OpenClaw watchOS app is not required for HealthKit summaries.

주요 항목:

An iPhone or iPad running the OpenClaw iOS app where HealthKit reports health data as
A connected and approved iOS node. See iOS app setup.
A current Gateway that can reach the iOS node.
Readable Health data for any metrics you expect to see. An Apple Watch can

Enable access

이 섹션의 세부 항목은 공식 문서 Enable access를 참고하세요.

1. Authorize the Gateway command

Add health.summary to the existing gateway.nodes.commands.allow array in openclaw.json. Preserve any commands already present:

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

Open Settings -> Permissions and find Apple Health Summaries in the always-visible Apple Health section. 2. Tap Enable Apple Health Summaries. 3. Read the disclosure, then choose which Health categories OpenClaw may read in Apple's permission sheet.

openclaw nodes pending
openclaw nodes approve <requestId>

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

Request today's summary

Only today is supported. It covers local midnight through the request time, using the iOS device's current calendar and time zone.

Field	Meaning
`period`	Always `today`
`startISO`	Local start of day, encoded as an ISO instant
`endISO`	Request time, encoded as an ISO instant
`timeZoneIdentifier`	iOS device time-zone identifier
`stepCount`	Rounded cumulative steps
`sleepDurationMinutes`	Deduplicated asleep time, clipped to today
`restingHeartRateBpm`	Average resting heart rate
`workoutCount`	Workouts that started today
`workoutDurationMinutes`	Total duration of those workouts

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

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

Privacy behavior

requests it, the aggregate reaches the configured AI provider and may remain in chat history. A direct CLI invocation returns it to the CLI operator.

주요 항목:

Aggregation happens on the iOS device. Raw samples do not leave the device.
The requested aggregate leaves the device through your Gateway. When an agent
OpenClaw requests read access only. It cannot add or modify Health data.
OpenClaw reads HealthKit only when health.summary is invoked. There is no
HealthKit deliberately does not reveal whether read access was denied. A
The summary is for personal health and fitness context, not diagnosis or

트러블슈팅

이 섹션의 세부 항목은 공식 문서 트러블슈팅를 참고하세요.

Command is not declared by the node

Confirm Apple Health summaries are enabled in the iOS app and the device is connected. Run openclaw nodes pending and approve any capability update, then inspect openclaw nodes describe --node "" again.

Command requires explicit opt-in

Add health.summary to gateway.nodes.commands.allow. Also check that gateway.nodes.commands.deny does not contain it; the deny list wins.

HEALTH_ACCESS_DISABLED

The app-side sharing switch is off. Enable Apple Health Summaries under

Summary succeeds but metrics are missing

Open Apple's Health app and confirm that data exists for today. Review OpenClaw's access in Apple's Health settings, but do not treat an empty result as proof that access was denied: HealthKit intentionally hides that distinction.

Older ranges fail

The command accepts only {"period":"today"}. Multi-day and historical summaries are not supported.

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/platforms/ios-healthkit
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

openclaw nodes pending
openclaw nodes approve <requestId>

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

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

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

HealthKit summaries

핵심 요약

Enable and invoke privacy-gated HealthKit summaries from an iOS node

한국어 가이드 범위: platforms/ios-healthkit 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

HealthKit summaries
요구사항
Enable access
1. Authorize the Gateway command
2. Enable sharing on the iOS device
Request today's summary
Privacy behavior
트러블슈팅
Command is not declared by the node
Command requires explicit opt-in
HEALTH_ACCESS_DISABLED
Summary succeeds but metrics are missing
Older ranges fail
관련 문서

상세 내용

HealthKit summaries

요구사항

contribute data to the Apple Health store, but the OpenClaw watchOS app is not required for HealthKit summaries.

주요 항목:

An iPhone or iPad running the OpenClaw iOS app where HealthKit reports health data as
A connected and approved iOS node. See iOS app setup.
A current Gateway that can reach the iOS node.
Readable Health data for any metrics you expect to see. An Apple Watch can

Enable access

이 섹션의 세부 항목은 공식 문서 Enable access를 참고하세요.

1. Authorize the Gateway command

Add health.summary to the existing gateway.nodes.commands.allow array in openclaw.json. Preserve any commands already present:

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

Open Settings -> Permissions and find Apple Health Summaries in the always-visible Apple Health section. 2. Tap Enable Apple Health Summaries. 3. Read the disclosure, then choose which Health categories OpenClaw may read in Apple's permission sheet.

openclaw nodes pending
openclaw nodes approve <requestId>

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

Request today's summary

Only today is supported. It covers local midnight through the request time, using the iOS device's current calendar and time zone.

Field	Meaning
`period`	Always `today`
`startISO`	Local start of day, encoded as an ISO instant
`endISO`	Request time, encoded as an ISO instant
`timeZoneIdentifier`	iOS device time-zone identifier
`stepCount`	Rounded cumulative steps
`sleepDurationMinutes`	Deduplicated asleep time, clipped to today
`restingHeartRateBpm`	Average resting heart rate
`workoutCount`	Workouts that started today
`workoutDurationMinutes`	Total duration of those workouts

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

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

Privacy behavior

requests it, the aggregate reaches the configured AI provider and may remain in chat history. A direct CLI invocation returns it to the CLI operator.

주요 항목:

Aggregation happens on the iOS device. Raw samples do not leave the device.
The requested aggregate leaves the device through your Gateway. When an agent
OpenClaw requests read access only. It cannot add or modify Health data.
OpenClaw reads HealthKit only when health.summary is invoked. There is no
HealthKit deliberately does not reveal whether read access was denied. A
The summary is for personal health and fitness context, not diagnosis or

트러블슈팅

이 섹션의 세부 항목은 공식 문서 트러블슈팅를 참고하세요.

Command is not declared by the node

Command requires explicit opt-in

Add health.summary to gateway.nodes.commands.allow. Also check that gateway.nodes.commands.deny does not contain it; the deny list wins.

HEALTH_ACCESS_DISABLED

The app-side sharing switch is off. Enable Apple Health Summaries under

Summary succeeds but metrics are missing

Older ranges fail

The command accepts only {"period":"today"}. Multi-day and historical summaries are not supported.

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/platforms/ios-healthkit
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

openclaw nodes pending
openclaw nodes approve <requestId>

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

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

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

HealthKit summaries

핵심 요약

문서 구성

상세 내용

HealthKit summaries

요구사항

Enable access

1. Authorize the Gateway command

2. Enable sharing on the iOS device

Request today's summary

Privacy behavior

트러블슈팅

Command is not declared by the node

Command requires explicit opt-in

HEALTH_ACCESS_DISABLED

Summary succeeds but metrics are missing

Older ranges fail

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

HealthKit summaries

핵심 요약

문서 구성

상세 내용

HealthKit summaries

요구사항

Enable access

1. Authorize the Gateway command

2. Enable sharing on the iOS device

Request today's summary

Privacy behavior

트러블슈팅

Command is not declared by the node

Command requires explicit opt-in

HEALTH_ACCESS_DISABLED

Summary succeeds but metrics are missing

Older ranges fail

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드