clawhealth-garmin (OpenClaw Skill)

Sync your Garmin Connect health data into a local SQLite database and expose it as structured JSON for OpenClaw agents.

Your agent can then query things like:

• "How did I sleep yesterday?"
• "What is my HRV trend this week?"
• "Am I overtraining?"

This is a thin wrapper skill around the published clawhealth Python package / CLI; it no longer fetches source code itself.

What It Does

• Login with username/password (MFA supported)
• Sync daily health summaries into SQLite (stage 1)
• Fetch HRV + training metrics via separate commands (stage 2)
• Fetch sleep stages + sleep score (stage 2)
• Fetch body composition (stage 2)
• Fetch activity lists and full activity details (stage 2)
• Fetch menstrual day view and calendar range if supported by garminconnect (experimental)
• Provide --json outputs for agent workflows
• Persist raw JSON payloads for later analysis

Prerequisites

• Python 3.10+
• Network access to Garmin Connect
• Garmin account (may require MFA)

If you run OpenClaw in Docker, you may prefer a prepatched image that already includes the required Python dependencies:

• ernestyu/openclaw-patched

Setup

1. Create {baseDir}/.env (see {baseDir}/ENV_EXAMPLE.md).

Recommended: use CLAWHEALTH_GARMIN_PASSWORD_FILE (password file) rather than CLAWHEALTH_GARMIN_PASSWORD (plaintext env var).

Note: relative paths in env vars (like ./garmin_pass.txt) are resolved relative to the skill directory by run_clawhealth.py.

2. Install the clawhealth package into a local .venv (if needed):

python {baseDir}/bootstrap_deps.py

3. Run the skill entrypoint via OpenClaw, which will invoke run_clawhealth.py.

See README.md / README_zh.md in this directory and the root repo for more details.