Health Guardian: Proactive Health Monitoring for AI Agents

What This Skill Does

The Health Guardian skill is a sophisticated tool designed for AI agents to proactively monitor the health of individuals, particularly those with chronic conditions. It integrates with Apple Health data, enabling real-time tracking of vital signs and other health metrics. The skill goes beyond simple data storage by actively detecting patterns, identifying deviations from normal ranges, and alerting caregivers or the agent when potential issues arise. This proactive approach aims to prevent health emergencies by providing early warnings based on learned individual baselines rather than generic population averages. The skill is battle-tested and developed with accessibility in mind, understanding the unique needs of individuals with disabilities.

Key features include integration with Apple Health via the Health Auto Export app, supporting a wide array of metrics such as heart rate, HRV, sleep patterns, temperature, blood pressure, and SpO2. It employs advanced pattern detection algorithms, including rolling averages, day-over-day comparisons, correlation analysis, and trend direction assessment. The skill generates proactive alerts for fever, heart rate anomalies, sleep degradation, and can even infer missed medication. It is built to be accessible, recognizing that 'normal' health metrics can vary significantly among individuals, and supports customized notification patterns for caregivers.

Installation

To install and configure the Health Guardian skill, follow these steps:

1. Install Health Auto Export on the iPhone:

   • Download and install the Health Auto Export app from the App Store.
   • Configure the app's settings: Ensure the export format is set to JSON, enable iCloud Drive sync, and set the export interval to hourly.
   • Note the export folder location: iCloud Drive/Health Auto Export/.

2. Configure the Skill:

   • Create a config.json file in the health-guardian skill directory.
   • Populate it with your specific details, including human_name, the correct data_source path (adjusting for your iCloud Drive location), import_interval, alert_channel, desired thresholds for key metrics, and baseline_period_days.
   • Example config.json:

     {
       "human_name": "Your Human",
       "data_source": "~/Library/Mobile Documents/com~apple~CloudDocs/Health Auto Export",
       "import_interval": "hourly",
       "alert_channel": "telegram",
       "thresholds": {
         "temperature_high": 100.4,
         "temperature_low": 96.0,
         "heart_rate_high": 120,
         "heart_rate_low": 50
       },
       "baseline_period_days": 14
     }
     

3. Set Up Cron Import:

   • Add the following to your agent's cron schedule to ensure hourly data import and analysis:

     {
       "name": "Health Import",
       "schedule": { "kind": "cron", "expr": "0 * * * *" },
       "payload": { "kind": "systemEvent", "text": "Run health import and check for anomalies" },
       "sessionTarget": "main"
     }
     

4. Integrate with Heartbeat:

   • Add a health check to your HEARTBEAT.md file to ensure alerts are generated and actioned:

     ## Health Check (if concerning patterns)
     If health data shows anomalies, alert human via preferred channel.
     

5. Install the Skill:

   • Use the command: clawhub install openclaw/skills/skills/cgtreadw/health-guardian

Use Cases

• Chronic Condition Management: Continuously monitor vital signs for individuals with conditions like heart disease, diabetes, or respiratory illnesses, providing early warnings for potential exacerbations.
• Post-Surgery Recovery: Track recovery progress by monitoring heart rate, sleep quality, and activity levels, alerting caregivers to any signs of complications.
• Elderly Care: Provide peace of mind for caregivers by monitoring seniors' health metrics, detecting anomalies that might indicate falls, infections, or other urgent issues.
• Disability Support: Assist agents in caring for individuals with disabilities by proactively managing their health data and alerting to any changes that require attention.
• Personal Health Awareness: For individuals who want a proactive health companion, the skill can provide insights into personal health trends and potential issues before they become serious.

Example Prompts

• "Run a health analysis for the last 7 days and report any significant anomalies."
• "Generate a weekly summary of [Human Name]'s health data."
• "Are there any critical alerts from the Health Guardian skill regarding [Human Name]'s current condition?"

Tips & Limitations

• Data Accuracy: The accuracy of the health data relies heavily on the sensors and input methods used by Apple Health. Ensure the iPhone's health tracking is correctly configured.
• Baseline Period: Allow the skill at least 7-14 days of data to establish a reliable baseline for detecting meaningful deviations. The baseline_period_days parameter in config.json is crucial for this.
• Threshold Customization: The default thresholds in config.json are examples. It is essential to customize these based on the specific medical needs and doctor's recommendations for the individual being monitored.
• Privacy: Ensure compliance with all relevant privacy regulations when handling sensitive health data. The skill processes data locally where possible, but data export and potential alert channels introduce external interactions.
• Inference Limitations: The skill's inference of missed medications is based on patterns (e.g., sudden changes in vitals after a medication schedule). It is not a direct substitute for medication adherence tracking or medical advice.
• Apple Health Sync: Reliant on the Health Auto Export app functioning correctly and syncing data to iCloud. Any disruptions in this sync will affect data availability for the Health Guardian.
• Alert Channel Reliability: The effectiveness of alerts depends on the chosen alert_channel (e.g., Telegram) and its reliable delivery.