How to Use OpenClaw
with Apple Health

How the OpenClaw + Apple Health Integration Works

The integration connects your local Apple Health data to OpenClaw through a privacy-first architecture. The Mac app processes your imported health data entirely on your machine and exposes a read-only localhost API. The ClawHub skill tells OpenClaw how to talk to that local API — so your data never leaves your computer.

Your health data stays on your Mac. The app runs a local-only API at http://127.0.0.1:8765. No data is uploaded, no cloud servers are involved, and the API is strictly read-only.

1 Install the Mac App

Download Health Data Export AI Analyzer from the Mac App Store. This is the app that imports, processes, and serves your Apple Health data locally.

Download Health Data Export AI Analyzer on the Mac App Store →

Once installed, launch the app. It will sit in your menu bar and start a local server at http://127.0.0.1:8765 that the OpenClaw skill connects to.

2 Import Your Apple Health Data

To get your health data onto your Mac, you need to export it from your iPhone and import it into the app.

Export from iPhone

1. Open the Health app on your iPhone
2. Tap your profile picture in the top-right corner
3. Scroll down and tap Export All Health Data
4. Confirm the export — this may take a few minutes depending on how much data you have
5. AirDrop or transfer the resulting ZIP file to your Mac

For a more detailed walkthrough, see our complete Apple Health export guide.

Import into the Mac App

Open Health Data Export AI Analyzer on your Mac and use the import function to load the ZIP file. The app will parse your health records locally and make them available through the API.

3 Install the ClawHub Skill

The ClawHub skill is what tells OpenClaw how to communicate with the Mac app's local API. Installing it is a one-click process.

1. Visit the skill page: clawhub.ai/krumjahn/apple-health-export-analyzer
2. Click Install to add the apple-health-export-analyzer skill to your OpenClaw account
3. The skill will appear in your installed skills list, ready for use

This is the OpenClaw ClawHub health skill setup step that bridges your local data with the AI. The skill reads from the app's daily brief endpoint — it never writes data or uploads anything.

4 Verify the Connection

Before asking OpenClaw for a health brief, confirm everything is working by testing the local API directly. Open Terminal on your Mac and run:

curl http://127.0.0.1:8765/openclaw/status

You should see a JSON response confirming the app is running, your dataset is loaded, available metrics, and timestamps for your last import. If the connection works, you can also test the daily brief endpoint:

curl "http://127.0.0.1:8765/openclaw/daily-brief?date=2026-03-19"

A successful response looks like this:

{
  "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"
  }
}

The response includes steps, sleep, workout data, baseline comparisons, and signals that flag notable deviations from your norms.

5 Ask for Your Daily Health Brief

Now open OpenClaw and ask for your Apple Health AI daily check-in. Here are example prompts that work well:

OpenClaw will use the ClawHub skill to fetch your health data from the local Mac app, then provide a plain-English summary with personalized suggestions based on your actual metrics and baselines.

Typical output includes:

• A summary of your key metrics (steps, sleep, heart rate, HRV, workouts)
• Comparisons against your 7-day baselines
• Flagged signals like activity below baseline or unusual heart rate
• Actionable suggestions tailored to the data

Troubleshooting

App Not Running — Connection Refused

If curl http://127.0.0.1:8765/openclaw/status returns "Connection refused," the Mac app isn't running. Launch Health Data Export AI Analyzer from your Applications folder. The local API starts automatically when the app is open.

No Dataset Loaded

If the status endpoint responds but shows no data or empty metrics, you haven't imported an Apple Health export yet. Go back to Step 2 and import your health data ZIP file.

OpenClaw Can't Fetch Data Locally

In some sessions, the OpenClaw runtime may not support local network fetch. If the skill reports it cannot reach the local endpoint:

• Verify the API works by running curl http://127.0.0.1:8765/openclaw/status directly in Terminal
• Make sure no firewall or VPN is blocking localhost connections on port 8765
• Try starting a new OpenClaw session and re-issuing the prompt