OpenClaw Integration

Connect OpenClaw to the Mac app’s local API and get daily health briefs, trend analysis, and actionable suggestions from your selected Apple Health dataset.

Your health data stays on your Mac. OpenClaw reads a local, read-only API exposed by the Mac app.

What is OpenClaw + Apple Health?

Your iPhone collects an incredible amount of health data every day -- steps, sleep duration, heart rate, HRV, workouts, and more. But Apple Health is better at collecting data than explaining it. You get raw numbers without the context that makes them useful.

The OpenClaw Apple Health integration changes that. The Health Data AI Analyzer Mac app exposes a local read-only API that OpenClaw can query through the apple-health-export-analyzer ClawHub skill. You can ask AI about your health in natural language and get a daily brief with status, trends, suggestions, and missing-data alerts.

Think of it as a personal health analyst that lives on your Mac. You ask a question; OpenClaw reads your local health data and delivers a structured summary with actionable insights.

How It Works

The integration has three components that connect locally on your Mac:

  1. Health Data AI Analyzer (Mac app) -- imports your Apple Health export and runs a read-only API on http://127.0.0.1:8765.
  2. ClawHub skill -- teaches OpenClaw how to call the Mac app's localhost API endpoints.
  3. OpenClaw -- sends natural-language requests, receives structured JSON, and returns a human-readable daily brief.

No remote service is required beyond the OpenClaw client and the local Mac app workflow.

Setup Steps

Step 1: Install the Mac App

Download Health Data AI Analyzer from the Mac App Store. It runs natively on macOS and processes everything locally.

Step 2: Get a Dataset into the Mac App

Import an Apple Health XML file into the Mac app, or use the iPhone sync workflow and pull the latest XML export from the Mac Sync tab. For a step-by-step walkthrough, see Getting Started.

Step 3: Install the ClawHub Skill

Add the apple-health-export-analyzer skill from ClawHub. This teaches OpenClaw how to read from your local health API. The current skill version is apple-health-export-analyzer@1.0.6.

Step 4: Enable the Local API and Choose an Integration Dataset

In the Mac app, open Settings and turn on Enable Local API for OpenClaw and scripts. If needed, select the dataset you want to use for integrations.

Step 5: Open OpenClaw and Ask for a Daily Brief

Open OpenClaw and ask for your daily health brief. The AI reads from the Mac app’s localhost API and returns a structured summary with suggestions. Try this prompt to get started:

Use the "health-analyzer-mac-local" skill for this request.
Give me my daily health brief for today and 3 suggestions.

What You Get: The Daily Brief

Each daily brief is structured around four sections that give you a complete picture of your day:

Section Description
Status Current numbers for steps, sleep, workouts, heart rate, and HRV.
What Changed How today compares to your 7-day baselines. Surfaces signal flags like activity_below_baseline.
Suggestions Actionable recommendations based on your data (e.g., "Take a 20-minute walk to close the gap with your step baseline").
Missing Data Alerts for any metrics that were not recorded for the requested date.

Daily Brief Data Fields

The daily brief JSON response includes these fields:

Field Type Description
steps object Current step count, 7-day baseline, and delta vs. baseline.
sleep object Sleep hours (or null if missing) and 7-day baseline.
workouts object Workout count and total minutes for the day.
heart_rate object Average and resting heart rate for the day.
hrv object Heart rate variability measurement.
signals array Machine-readable flags like activity_below_baseline used to surface suggestions.
context_summary string Human-readable one-line summary of the day's data.

Example Response

{
  "ok": true,
  "success": true,
  "summary": "Daily Apple Health brief from Health Data AI Analyzer.",
  "data": {
    "date": "2026-03-19",
    "steps": {
      "value": 2444,
      "baseline_7d": 10004.57,
      "delta_vs_baseline": -7560.57
    },
    "sleep": { "hours": null, "baseline_7d": 6.47 },
    "workouts": { "count": 0, "total_minutes": 0 },
    "signals": ["activity_below_baseline"],
    "context_summary": "Daily brief for 2026-03-19, steps 2444"
  }
}

Example Prompts

Copy any of these prompts and paste them directly into OpenClaw. For a full collection, see the prompt library.

Daily Brief

Use the "health-analyzer-mac-local" skill for this request.
Give me my daily health brief for today and 3 suggestions.

Specific Date

Use the "health-analyzer-mac-local" skill for this request.
Give me my daily health brief for 2026-03-19 and 3 suggestions for that day.

Week in Review

Use the "health-analyzer-mac-local" skill for this request.
Pull my daily brief for the last 7 days and summarize trends in my steps, sleep, and activity.

Follow-Up Questions

Once OpenClaw has your health data in context, you can ask natural follow-up questions:

  • "Why were my steps so low on Wednesday?"
  • "Compare this week to last week."
  • "Which days did I miss workouts?"
  • "What is my average sleep this month?"

Privacy

This integration is built around a simple rule: your health data stays on your Mac.

  • Local processing -- the Mac app processes your imported Apple Health data entirely on your machine. Nothing is sent to external servers.
  • Read-only API -- the localhost API is read-only. OpenClaw can query your data but cannot modify, delete, or write to your health records.
  • No app-operated cloud uploads -- the ClawHub skill reads from localhost only.

For full API documentation, see the API Reference.

Current Skill Version

The current ClawHub skill version is apple-health-export-analyzer@1.0.6. You can view the skill definition and install it from ClawHub.