SomviaWhat OpenClaw supports natively
OpenClaw's native iOS HealthKit feature is intentionally narrow and local. As of July 22, 2026, it aggregates the current calendar day on the device and returns steps, sleep duration, average resting heart rate, and workout count and duration. It does not return individual samples, historical ranges, background ingestion, or workout series.
That is a strong option when today's compact summary is all you need and you prefer the raw data to stay on-device. The current scope is documented in the official OpenClaw HealthKit guide.
Native summary or Somvia remote MCP?
| Capability | OpenClaw native summary | Somvia remote MCP |
|---|---|---|
| Date range | Current calendar day | Everything synced, starting up to 180 days before the first sync |
| Health detail | Four compact aggregate categories | Selected metrics, sleep stages, workouts, splits, and available series |
| Data movement | Aggregated on-device when invoked | Selected data syncs over encrypted transport to Somvia's hosted service |
| Phone availability | The connected iOS node participates in the request | OpenClaw reads the most recently synced data from the remote endpoint |
| Best use | “How am I doing today?” | Historical comparisons and workout analysis |
You can use both. Keep the native summary for today's on-device context, and call Somvia only when a question needs history or workout depth. They solve different jobs.
Connect OpenClaw to Somvia
-
Prepare the Apple Health data
Install Somvia, sign in with Apple, activate Pro, select the Health categories and history window you want, then open Connection from Today or Settings, turn on Sync to the Somvia server, and let the first sync finish. Upload is off by default, and OpenClaw can only retrieve data that has reached your Somvia account.
-
Copy the access token
From Somvia's agent connection screen, copy the private token beginning with
som_. -
Make the token available to OpenClaw
Set the token in the environment used by the OpenClaw process or gateway. For an interactive shell:
export SOMVIA_ACCESS_TOKEN='som_your_private_token_here'If OpenClaw runs as a service, put the variable in that service's secret environment and restart it. Do not commit the value.
-
Add the Streamable HTTP server
openclaw mcp set somvia '{ "url": "https://somvia.app/mcp", "transport": "streamable-http", "headers": { "Authorization": "Bearer ${SOMVIA_ACCESS_TOKEN}" } }'This matches OpenClaw's current official outbound MCP configuration.
-
Probe the live connection
openclaw mcp doctor somvia --probeThe probe should open the MCP connection and report discovered tools. If the gateway owns the runtime, reload or restart that process after changing its environment.
Questions that need more than today
- Compare my sleep duration, HRV, and resting heart rate over the last two weeks.
- List my runs this month and compare their pace and average heart rate.
- Inspect the available heart-rate and speed series for my last interval workout.
- Did my recent long runs show more or less heart-rate drift at similar pace?
The privacy trade-off, plainly
OpenClaw's native summary performs aggregation on the device and sends only that compact result through your gateway. Somvia instead maintains a hosted copy of the Health data you selected so it remains queryable over time and from multiple clients. Somvia encrypts transport, stores access tokens only as hashes, and lets you delete the account and synced data in the app—but it is still a cloud service.
Choose the native path when local, current-day context is enough. Choose Somvia when the value of history, background sync, and workout depth justifies the hosted copy.
Frequently asked questions
Does OpenClaw already support Apple Health?
Yes. Its native feature currently returns an on-device summary for today: steps, sleep duration, average resting heart rate, and workout count and duration. It does not include multi-day history or workout series.
When would I use Somvia with OpenClaw?
Use Somvia for selected historical metrics, background sync, or workout-level details such as splits and available heart-rate, speed, route, power, or cadence series.
Can I use both?
Yes. Use OpenClaw's native summary for a device-local view of today and Somvia for historical or workout questions that need previously synced data.