Résumés HealthKit

OpenClaw peut demander à un Node iPhone connecté un résumé en lecture seule de la journée calendaire en cours. L’iPhone calcule l’agrégat sur l’appareil et renvoie uniquement le nombre de pas, la durée du sommeil, la fréquence cardiaque moyenne au repos, ainsi que le nombre et la durée des entraînements. Les échantillons HealthKit individuels, les sources, les métadonnées, les dossiers cliniques, l’ingestion en arrière-plan et les écritures ne sont pas pris en charge.

Cette fonctionnalité est désactivée par défaut. Elle nécessite un consentement distinct sur l’iPhone et une autorisation sur le Gateway.

Prérequis

• Un iPhone exécutant l’app iOS OpenClaw sur lequel HealthKit indique que les données de santé sont disponibles.
• Un Node iPhone connecté et approuvé. Consultez Configuration de l’app iOS.
• Un Gateway à jour pouvant joindre le Node iPhone.
• Des données Santé lisibles pour toutes les métriques que vous souhaitez consulter. Une Apple Watch peut fournir des données au stockage Santé de l’iPhone, mais l’app watchOS OpenClaw n’est pas requise pour les résumés HealthKit.

Activer l’accès

1. Autoriser la commande du Gateway

Ajoutez health.summary au tableau gateway.nodes.allowCommands existant dans openclaw.json. Conservez toutes les commandes déjà présentes :

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

health.summary est classée comme hautement sensible en matière de confidentialité et n’est jamais autorisée par défaut sur la plateforme iOS. Une entrée dans gateway.nodes.denyCommands prévaut sur l’entrée d’autorisation. Consultez Politique des commandes des Nodes.

2. Activer le partage sur l’iPhone

Dans l’app iOS :

1. Ouvrez Settings -> Permissions -> Privacy & Access -> Health Summaries.
2. Touchez Enable & Share Summaries.
3. Lisez l’avis, puis choisissez les catégories Santé qu’OpenClaw peut lire dans la feuille d’autorisation d’Apple.

Le commutateur enregistre votre choix explicite de partager avec OpenClaw. Il ne signifie pas qu’Apple a accordé l’accès à toutes les catégories demandées.

L’activation des résumés Santé ajoute health.summary à la surface de commandes déclarée du Node. Approuvez la mise à jour d’association du Node qui en résulte :

openclaw nodes pendingopenclaw nodes approve <requestId>

Vérifiez ensuite que l’iPhone connecté expose une commande health.summary effective :

openclaw nodes describe --node "<iPhone name>"

Demander le résumé du jour

Seul today est pris en charge. Il couvre la période allant de minuit, heure locale, jusqu’à l’heure de la demande, selon le calendrier et le fuseau horaire actuels de l’iPhone.

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

Les agents peuvent appeler la même commande avec l’outil nodes :

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

La charge utile du résumé contient :

Les champs de métriques sont facultatifs et sont omis lorsque HealthKit ne renvoie aucune valeur lisible. Les phases de sommeil et les sources qui se chevauchent sont fusionnées avant le calcul de la durée afin qu’une même minute ne soit pas comptée deux fois.

Comportement relatif à la confidentialité

• L’agrégation s’effectue sur l’iPhone. Les échantillons bruts ne quittent pas l’appareil.
• L’agrégat demandé quitte l’iPhone via votre Gateway. Lorsqu’un agent le demande, l’agrégat parvient au fournisseur d’IA configuré et peut rester dans l’historique de la conversation. Un appel direct depuis la CLI le renvoie à l’opérateur de la CLI.
• OpenClaw demande uniquement un accès en lecture. Il ne peut ni ajouter ni modifier les données Santé.
• OpenClaw lit HealthKit uniquement lorsque health.summary est appelée. Aucune ingestion de données de santé ne s’effectue en arrière-plan.
• HealthKit ne révèle délibérément pas si l’accès en lecture a été refusé. Une métrique manquante peut signifier que l’accès a été refusé, qu’aucun échantillon correspondant n’existe ou qu’un type de données est indisponible. OpenClaw ne peut pas distinguer ces situations.
• Le résumé fournit un contexte personnel de santé et de forme physique, et non un diagnostic ou un avis médical.

Pour arrêter le partage, revenez à Health Summaries et touchez Disable. L’iPhone retire alors la capacité Santé et la commande health.summary de la surface de son Node. Vous pouvez également retirer health.summary de gateway.nodes.allowCommands afin de fermer le contrôle d’accès côté Gateway.

Résolution des problèmes

La commande n’est pas déclarée par le Node

Vérifiez que les résumés Santé sont activés dans l’app iOS et que l’iPhone est connecté. Exécutez openclaw nodes pending et approuvez toute mise à jour des capacités, puis examinez de nouveau openclaw nodes describe --node "<iPhone name>".

La commande nécessite une activation explicite

Ajoutez health.summary à gateway.nodes.allowCommands. Vérifiez également que gateway.nodes.denyCommands ne la contient pas ; la liste de refus prévaut.

HEALTH_ACCESS_DISABLED

Le commutateur de partage de l’app est désactivé. Activez Health Summaries sous Privacy & Access sur l’iPhone.

Le résumé aboutit, mais des métriques sont manquantes

Ouvrez l’app Santé d’Apple et vérifiez que des données existent pour aujourd’hui. Vérifiez l’accès d’OpenClaw dans les réglages Santé d’Apple, mais ne considérez pas un résultat vide comme la preuve que l’accès a été refusé : HealthKit masque intentionnellement cette distinction.

Les plages plus anciennes échouent

La commande accepte uniquement {"period":"today"}. Les résumés historiques et sur plusieurs jours ne sont pas pris en charge.

Voir aussi

• App iOS
• Nodes
• Référence de configuration du Gateway
• Audit de sécurité