HealthKit サマリー

OpenClaw は、接続された iPhone または iPad の Node から、現在の暦日の読み取り専用サマリーをリクエストできます。デバイス上で集計を行い、歩数、睡眠時間、平均安静時心拍数、ワークアウトの回数と時間のみを返します。個々の HealthKit サンプル、ソース、メタデータ、臨床記録、バックグラウンドでの取り込み、書き込みはサポートされていません。

この機能はデフォルトでは無効です。iOS デバイス上での個別の同意と、Gateway での承認が必要です。

要件

• HealthKit がヘルスケアデータを利用可能と報告する、OpenClaw iOS アプリを実行中の iPhone または iPad。
• 接続および承認済みの iOS Node。iOS アプリのセットアップを参照してください。
• iOS Node に到達できる最新の Gateway。
• 表示する予定の各指標について、読み取り可能なヘルスケアデータ。Apple Watch は Apple ヘルスケアストアにデータを提供できますが、HealthKit サマリーに OpenClaw watchOS アプリは必要ありません。

アクセスを有効にする

1. Gateway コマンドを承認する

openclaw.json の既存の gateway.nodes.commands.allow 配列に health.summary を追加します。すでに存在するコマンドは維持してください。

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

health.summary はプライバシーへの影響が大きいものとして分類され、iOS プラットフォームのデフォルトでは許可されません。gateway.nodes.commands.deny のエントリは許可エントリより優先されます。Node コマンドポリシーを参照してください。

2. iOS デバイスで共有を有効にする

iOS アプリで、次の操作を行います。

1. Settings -> Permissions を開き、常に表示される Apple Health セクションで Apple Health Summaries を見つけます。
2. Enable Apple Health Summaries をタップします。
3. 開示内容を読み、Apple の権限シートで OpenClaw に読み取りを許可するヘルスケアカテゴリを選択します。

このスイッチには、OpenClaw との共有を明示的に選択したことが記録されます。Apple がリクエストされたすべてのカテゴリを許可したことを示すものではありません。

ヘルスケアサマリーを有効にすると、Node が宣言するコマンドサーフェスに health.summary が追加されます。その結果生じる Node ペアリングの更新を承認します。

openclaw nodes pendingopenclaw nodes approve <requestId>

次に、接続された iOS デバイスが有効な health.summary コマンドを公開していることを確認します。

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

今日のサマリーをリクエストする

today のみがサポートされています。iOS デバイスの現在のカレンダーとタイムゾーンを使用し、現地時刻の午前 0 時からリクエスト時刻までが対象です。

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

エージェントは nodes ツールを使用して同じコマンドを呼び出せます。

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

サマリーペイロードには次の内容が含まれます。

指標フィールドは任意であり、HealthKit が読み取り可能な値を返さない場合は省略されます。時間を計算する前に睡眠ステージと重複するソースが統合されるため、同じ 1 分間が二重にカウントされることはありません。

プライバシーに関する動作

• 集計は iOS デバイス上で行われます。生のサンプルがデバイスから外部に送信されることはありません。
• リクエストされた集計は、Gateway を介してデバイスの外部に送信されます。エージェントがリクエストした場合、集計は構成された AI プロバイダーに送られ、チャット履歴に残ることがあります。CLI から直接呼び出した場合は、CLI オペレーターに返されます。
• OpenClaw がリクエストするのは読み取りアクセスのみです。ヘルスケアデータの追加や変更はできません。
• OpenClaw が HealthKit を読み取るのは、health.summary が呼び出された場合のみです。バックグラウンドでのヘルスケアデータの取り込みは行われません。
• HealthKit は、読み取りアクセスが拒否されたかどうかを意図的に開示しません。指標がない場合、アクセスが拒否された、該当するサンプルがない、またはデータ型が利用できない可能性があります。OpenClaw はこれらのケースを区別できません。
• このサマリーは個人の健康およびフィットネスに関するコンテキストを目的としており、診断や医学的助言を目的とするものではありません。

共有を停止するには、Apple Health Summaries に戻り、Turn Off Summaries をタップします。その後、iOS デバイスは Node サーフェスからヘルスケア機能と health.summary コマンドを削除します。gateway.nodes.commands.allow から health.summary を削除して、Gateway 側のゲートを閉じることもできます。

トラブルシューティング

コマンドが Node によって宣言されていない

iOS アプリで Apple ヘルスケアサマリーが有効になっており、デバイスが接続されていることを確認します。openclaw nodes pending を実行して機能の更新があれば承認し、openclaw nodes describe --node "<iOS device name>" を再度確認します。

コマンドには明示的なオプトインが必要

gateway.nodes.commands.allow に health.summary を追加します。また、gateway.nodes.commands.deny にそれが含まれていないことを確認してください。拒否リストが優先されます。

HEALTH_ACCESS_DISABLED

アプリ側の共有スイッチがオフになっています。iOS デバイスで Settings -> Permissions -> Apple Health を開き、Apple Health Summaries を有効にします。

サマリーは成功するが指標がない

Apple のヘルスケアアプリを開き、今日のデータが存在することを確認します。Apple のヘルスケア設定で OpenClaw のアクセス権を確認してください。ただし、結果が空であってもアクセスが拒否された証拠とはみなさないでください。HealthKit は意図的にその違いを隠します。

過去の期間を指定すると失敗する

このコマンドで使用できるのは {"period":"today"} のみです。複数日および過去のサマリーはサポートされていません。

関連項目

• iOS アプリ
• Node
• Gateway 構成リファレンス
• セキュリティ監査