Platforms overview
HealthKit-Zusammenfassungen
HealthKit-Zusammenfassungen
OpenClaw kann von einem verbundenen iPhone- oder iPad-Node eine schreibgeschützte Zusammenfassung des aktuellen Kalendertags anfordern. Das Gerät berechnet die aggregierten Daten direkt auf dem Gerät und gibt nur die Schrittzahl, Schlafdauer, durchschnittliche Ruheherzfrequenz sowie Anzahl und Dauer der Trainingseinheiten zurück. Einzelne HealthKit-Datensätze, Quellen, Metadaten, klinische Aufzeichnungen, Hintergrundimport und Schreibvorgänge werden nicht unterstützt.
Diese Funktion ist standardmäßig deaktiviert. Sie erfordert eine separate Einwilligung auf dem iOS-Gerät und eine Autorisierung auf dem Gateway.
Voraussetzungen
- Ein iPhone oder iPad, auf dem die OpenClaw-iOS-App ausgeführt wird und HealthKit Gesundheitsdaten als verfügbar meldet.
- Ein verbundener und genehmigter iOS-Node. Siehe Einrichtung der iOS-App.
- Ein aktueller Gateway, der den iOS-Node erreichen kann.
- Lesbare Gesundheitsdaten für alle Metriken, die angezeigt werden sollen. Eine Apple Watch kann Daten zum Apple-Health-Speicher beitragen, die OpenClaw-watchOS-App ist für HealthKit-Zusammenfassungen jedoch nicht erforderlich.
Zugriff aktivieren
1. Gateway-Befehl autorisieren
Fügen Sie health.summary zum vorhandenen Array gateway.nodes.commands.allow in
openclaw.json hinzu. Behalten Sie alle bereits vorhandenen Befehle bei:
{ gateway: { nodes: { commands: { allow: ["health.summary"] }, }, },}health.summary wird als besonders datenschutzrelevant eingestuft und ist gemäß der Standardeinstellung der iOS-Plattform niemals zulässig. Ein Eintrag in gateway.nodes.commands.deny überschreibt den Zulassungseintrag. Siehe Node-Befehlsrichtlinie.
2. Freigabe auf dem iOS-Gerät aktivieren
In der iOS-App:
- Öffnen Sie Settings -> Permissions und suchen Sie im stets sichtbaren Abschnitt Apple Health nach Apple Health Summaries.
- Tippen Sie auf Enable Apple Health Summaries.
- Lesen Sie den Hinweis und wählen Sie anschließend im Berechtigungsdialog von Apple aus, welche Health-Kategorien OpenClaw lesen darf.
Der Schalter speichert Ihre ausdrückliche Entscheidung zur Freigabe für OpenClaw. Er bedeutet nicht, dass Apple jede angeforderte Kategorie freigegeben hat.
Durch die Aktivierung der Health-Zusammenfassungen wird health.summary zur deklarierten Befehlsoberfläche des Nodes hinzugefügt. Genehmigen Sie die daraus resultierende Aktualisierung der Node-Kopplung:
openclaw nodes pendingopenclaw nodes approve <requestId>Überprüfen Sie anschließend, ob das verbundene iOS-Gerät einen wirksamen Befehl health.summary bereitstellt:
openclaw nodes describe --node "<iOS device name>"Heutige Zusammenfassung anfordern
Es wird nur today unterstützt. Der Zeitraum reicht von der lokalen Mitternacht bis zum Zeitpunkt der Anfrage und verwendet den aktuellen Kalender und die Zeitzone des iOS-Geräts.
openclaw nodes invoke \ --node "<iOS device name>" \ --command health.summary \ --params '{"period":"today"}' \ --jsonAgenten können denselben Befehl mit dem Tool nodes aufrufen:
{ "action": "invoke", "node": "<iOS device name>", "invokeCommand": "health.summary", "invokeParamsJson": "{\"period\":\"today\"}"}Die Nutzlast der Zusammenfassung enthält:
| Feld | Bedeutung |
|---|---|
period |
Immer today |
startISO |
Lokaler Tagesbeginn, als ISO-Zeitpunkt codiert |
endISO |
Anfragezeitpunkt, als ISO-Zeitpunkt codiert |
timeZoneIdentifier |
Zeitzonenkennung des iOS-Geräts |
stepCount |
Gerundete kumulierte Schrittzahl |
sleepDurationMinutes |
Deduplizierte Schlafdauer, auf heute begrenzt |
restingHeartRateBpm |
Durchschnittliche Ruheherzfrequenz |
workoutCount |
Heute begonnene Trainingseinheiten |
workoutDurationMinutes |
Gesamtdauer dieser Trainingseinheiten |
Metrikfelder sind optional und werden ausgelassen, wenn HealthKit keinen lesbaren Wert zurückgibt. Schlafphasen und sich überschneidende Quellen werden vor der Berechnung der Dauer zusammengeführt, sodass dieselbe Minute nicht doppelt gezählt wird.
Datenschutzverhalten
- Die Aggregation erfolgt auf dem iOS-Gerät. Rohdaten verlassen das Gerät nicht.
- Die angeforderten aggregierten Daten verlassen das Gerät über Ihren Gateway. Wenn ein Agent sie anfordert, erreichen die aggregierten Daten den konfigurierten KI-Provider und können im Chatverlauf verbleiben. Ein direkter CLI-Aufruf gibt sie an den CLI-Bediener zurück.
- OpenClaw fordert ausschließlich Lesezugriff an. Es kann keine Gesundheitsdaten hinzufügen oder ändern.
- OpenClaw liest HealthKit nur, wenn
health.summaryaufgerufen wird. Es erfolgt kein Hintergrundimport von Gesundheitsdaten. - HealthKit legt bewusst nicht offen, ob der Lesezugriff verweigert wurde. Eine fehlende Metrik kann auf einen verweigerten Zugriff, fehlende passende Datensätze oder einen nicht verfügbaren Datentyp zurückzuführen sein. OpenClaw kann diese Fälle nicht unterscheiden.
- Die Zusammenfassung dient dem persönlichen Gesundheits- und Fitnesskontext, nicht der Diagnose oder medizinischen Beratung.
Um die Freigabe zu beenden, kehren Sie zu Apple Health Summaries zurück und tippen Sie auf Turn Off Summaries. Das iOS-Gerät entfernt daraufhin die Health-Funktion und den Befehl health.summary von seiner Node-Oberfläche. Sie können außerdem health.summary aus gateway.nodes.commands.allow entfernen, um die Zugriffssperre auf der Gateway-Seite zu schließen.
Fehlerbehebung
Der Befehl wird vom Node nicht deklariert
Vergewissern Sie sich, dass Apple-Health-Zusammenfassungen in der iOS-App aktiviert sind und das Gerät verbunden ist. Führen Sie openclaw nodes pending aus, genehmigen Sie alle Aktualisierungen der Funktionen und prüfen Sie anschließend erneut openclaw nodes describe --node "<iOS device name>".
Der Befehl erfordert eine ausdrückliche Aktivierung
Fügen Sie health.summary zu gateway.nodes.commands.allow hinzu. Stellen Sie außerdem sicher, dass gateway.nodes.commands.deny den Eintrag nicht enthält; die Sperrliste hat Vorrang.
HEALTH_ACCESS_DISABLED
Der Freigabeschalter in der App ist deaktiviert. Aktivieren Sie auf dem iOS-Gerät Apple Health Summaries unter Settings -> Permissions -> Apple Health.
Die Zusammenfassung ist erfolgreich, aber Metriken fehlen
Öffnen Sie Apples Health-App und vergewissern Sie sich, dass für heute Daten vorhanden sind. Prüfen Sie den Zugriff von OpenClaw in den Health-Einstellungen von Apple, interpretieren Sie ein leeres Ergebnis jedoch nicht als Nachweis dafür, dass der Zugriff verweigert wurde: HealthKit verbirgt diese Unterscheidung absichtlich.
Ältere Zeiträume schlagen fehl
Der Befehl akzeptiert nur {"period":"today"}. Mehrtägige und historische Zusammenfassungen werden nicht unterstützt.
