Healthclaw Webhook
Skill by crxiaobailiu-gif
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/crxiaobailiu-gif/healthclaw-webhookHealthClaw Skill
Connect your iPhone/Apple Watch health data to OpenClaw for AI-powered analysis.
HealthClaw streams Apple Health data (heart rate, HRV, sleep, steps, workouts) to your OpenClaw agent via a local webhook server. Once connected, your agent can calculate recovery scores, detect health anomalies, answer questions about your health trends, and proactively alert you when something looks off.
How It Works
iPhone / Apple Watch
↓ (HealthKit → background sync)
iOS App (HealthClaw)
↓ (HTTPS POST)
Webhook Server ← npx healthclaw-webhook-server
↓
health-data.jsonl (append-only log)
↓
OpenClaw Agent (queries, crons, alerts)
Key concepts
| Concept | Description |
|---|---|
| Pairing | One-time setup: server issues a time-limited token (2 min), iOS app scans or opens the deep-link, exchanges it for a permanent API token stored securely on the server |
| Data sync | iOS app POSTs individual records to /api/health-sync or bulk batches to /api/health-sync/batch. Each record contains a type, value, unit, startDate, endDate, and optional metadata |
| Deduplication | Every record gets a deterministic ID from (type, startDate, endDate, value). The server keeps a SQLite dedupe index — re-syncing the same data is always safe, duplicates are silently dropped |
| Storage | All data is appended to health-data.jsonl in a platform-appropriate user directory (~/Library/Application Support/healthclaw-webhook on macOS) |
Setup
1. Start the webhook server
npx healthclaw-webhook-server
The server starts on port 3000 by default. Keep it running (consider a LaunchAgent / systemd service for persistence).
Optional environment variables:
PORT=3000 # Server port
HEALTHCLAW_DATA_DIR=~/custom/path # Override data directory
ADMIN_TOKEN=your-secret # Protect admin endpoints
2. Expose to the internet (for iOS sync)
The iOS app needs to reach your server from outside your local network.
Option A: Tailscale Funnel (recommended)
Tailscale Funnel gives your machine a stable public HTTPS URL tied to your Tailscale domain — no dynamic DNS, no port forwarding needed.
# 1. Install Tailscale and log in (skip if already done)
# https://tailscale.com/download
tailscale login
# 2. Enable Funnel for port 3000
tailscale funnel --bg 3000
Your public URL will be:
https://<machine-name>.<tailnet-name>.ts.net
To find it:
tailscale funnel status
# or
tailscale status --json | grep DNSName
Note: Funnel runs in the background (
--bg). It persists across reboots. To stop it:tailscale funnel --bg --off
Option B: Cloudflare Tunnel
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-crxiaobailiu-gif-healthclaw-webhook": {
"enabled": true,
"auto_update": true
}
}
}