Platforms overview
HealthKit-samenvattingen
HealthKit-samenvattingen
OpenClaw kan bij een verbonden iPhone-Node een alleen-lezen samenvatting van de huidige kalenderdag opvragen. De iPhone berekent het totaal op het apparaat en retourneert alleen het aantal stappen, de slaapduur, de gemiddelde hartslag in rust en het aantal/de duur van trainingen. Afzonderlijke HealthKit-metingen, bronnen, metadata, klinische dossiers, verwerking op de achtergrond en schrijfbewerkingen worden niet ondersteund.
Deze functie is standaard uitgeschakeld. Hiervoor zijn afzonderlijke toestemming op de iPhone en autorisatie op de Gateway vereist.
Vereisten
- Een iPhone waarop de OpenClaw-app voor iOS wordt uitgevoerd en waarvoor HealthKit aangeeft dat gezondheidsgegevens beschikbaar zijn.
- Een verbonden en goedgekeurde iPhone-Node. Zie Configuratie van de iOS-app.
- Een actuele Gateway die de iPhone-Node kan bereiken.
- Leesbare Health-gegevens voor alle meetwaarden die je verwacht te zien. Een Apple Watch kan gegevens aan de Health-opslag op de iPhone toevoegen, maar de OpenClaw-app voor watchOS is niet vereist voor HealthKit-samenvattingen.
Toegang inschakelen
1. Autoriseer de Gateway-opdracht
Voeg health.summary toe aan de bestaande gateway.nodes.allowCommands-array in openclaw.json. Behoud alle reeds aanwezige opdrachten:
{ gateway: { nodes: { allowCommands: ["health.summary"], }, },}health.summary is geclassificeerd als zeer privacygevoelig en wordt volgens de standaardinstellingen van het iOS-platform nooit toegestaan. Een vermelding in gateway.nodes.denyCommands heeft voorrang op de vermelding waarmee de opdracht wordt toegestaan. Zie Opdrachtbeleid voor Nodes.
2. Delen op de iPhone inschakelen
In de iOS-app:
- Open Settings -> Permissions -> Privacy & Access -> Health Summaries.
- Tik op Enable & Share Summaries.
- Lees de toelichting en kies vervolgens in het toestemmingsvenster van Apple welke Health-categorieën OpenClaw mag lezen.
De schakelaar registreert je uitdrukkelijke keuze om gegevens met OpenClaw te delen. Dit betekent niet dat Apple toegang tot elke aangevraagde categorie heeft verleend.
Als je HealthKit-samenvattingen inschakelt, wordt health.summary toegevoegd aan het door de Node gedeclareerde opdrachtoppervlak. Keur de resulterende update van de Node-koppeling goed:
openclaw nodes pendingopenclaw nodes approve <requestId>Controleer vervolgens of de verbonden iPhone daadwerkelijk een health.summary-opdracht beschikbaar stelt:
openclaw nodes describe --node "<iPhone name>"De samenvatting van vandaag opvragen
Alleen today wordt ondersteund. Dit bestrijkt de periode vanaf lokale middernacht tot het tijdstip van de aanvraag, op basis van de huidige kalender en tijdzone van de iPhone.
openclaw nodes invoke \ --node "<iPhone name>" \ --command health.summary \ --params '{"period":"today"}' \ --jsonAgents kunnen dezelfde opdracht aanroepen met de tool nodes:
{ "action": "invoke", "node": "<iPhone name>", "invokeCommand": "health.summary", "invokeParamsJson": "{\"period\":\"today\"}"}De samenvattingspayload bevat:
| Veld | Betekenis |
|---|---|
period |
Altijd today |
startISO |
Lokaal begin van de dag, gecodeerd als een ISO-tijdstip |
endISO |
Tijdstip van de aanvraag, gecodeerd als een ISO-tijdstip |
timeZoneIdentifier |
Tijdzone-identificatie van de iPhone |
stepCount |
Afgerond cumulatief aantal stappen |
sleepDurationMinutes |
Ontdubbelde slaaptijd, beperkt tot vandaag |
restingHeartRateBpm |
Gemiddelde hartslag in rust |
workoutCount |
Trainingen die vandaag zijn begonnen |
workoutDurationMinutes |
Totale duur van die trainingen |
Velden met meetwaarden zijn optioneel en worden weggelaten wanneer HealthKit geen leesbare waarde retourneert. Slaapfasen en overlappende bronnen worden samengevoegd voordat de duur wordt berekend, zodat dezelfde minuut niet tweemaal wordt geteld.
Privacygedrag
- De aggregatie vindt plaats op de iPhone. Ruwe metingen verlaten het apparaat niet.
- Het opgevraagde totaal verlaat de iPhone via je Gateway. Wanneer een agent dit opvraagt, bereikt het totaal de geconfigureerde AI-provider en kan het in de chatgeschiedenis bewaard blijven. Bij een directe CLI-aanroep wordt het aan de CLI-operator geretourneerd.
- OpenClaw vraagt uitsluitend leestoegang aan. Het kan geen Health-gegevens toevoegen of wijzigen.
- OpenClaw leest HealthKit alleen wanneer
health.summarywordt aangeroepen. Er vindt geen verwerking van gezondheidsgegevens op de achtergrond plaats. - HealthKit maakt bewust niet bekend of leestoegang is geweigerd. Een ontbrekende meetwaarde kan wijzen op geweigerde toegang, het ontbreken van overeenkomende metingen of een niet-beschikbaar gegevenstype. OpenClaw kan deze gevallen niet van elkaar onderscheiden.
- De samenvatting is bedoeld als context voor persoonlijke gezondheid en conditie, niet voor diagnoses of medisch advies.
Ga terug naar Health Summaries en tik op Disable om het delen te stoppen. De iPhone verwijdert vervolgens de Health-mogelijkheid en de opdracht health.summary uit het Node-oppervlak. Je kunt ook health.summary uit gateway.nodes.allowCommands verwijderen om de toegang aan de Gateway-zijde af te sluiten.
Problemen oplossen
De opdracht wordt niet door de Node gedeclareerd
Controleer of HealthKit-samenvattingen in de iOS-app zijn ingeschakeld en of de iPhone verbonden is. Voer openclaw nodes pending uit, keur eventuele updates van mogelijkheden goed en controleer vervolgens openclaw nodes describe --node "<iPhone name>" opnieuw.
De opdracht vereist uitdrukkelijke aanmelding
Voeg health.summary toe aan gateway.nodes.allowCommands. Controleer ook of gateway.nodes.denyCommands deze opdracht niet bevat; de lijst met geweigerde opdrachten heeft voorrang.
HEALTH_ACCESS_DISABLED
De schakelaar voor delen in de app is uitgeschakeld. Schakel Health Summaries onder Privacy & Access op de iPhone in.
De samenvatting slaagt, maar er ontbreken meetwaarden
Open de Health-app van Apple en controleer of er gegevens voor vandaag bestaan. Controleer de toegang van OpenClaw in de Health-instellingen van Apple, maar beschouw een leeg resultaat niet als bewijs dat toegang is geweigerd: HealthKit verbergt dit onderscheid bewust.
Oudere perioden mislukken
De opdracht accepteert alleen {"period":"today"}. Samenvattingen van meerdere dagen en historische samenvattingen worden niet ondersteund.
