Amazfit GTR3 Health Log Skill#

Automatically fetches Amazfit GTR3 health data from HCGateway and writes a structured daily Obsidian note.

When Triggered#

• User says: "health log", "fetch GTR3 data", "write health data", "health log for yesterday/today/[date]"
• Daily cron job runs at 06:00 (configurable)

Prerequisites#

• HCGateway is running at http://127.0.0.1:6644
• Docker containers hcgateway_api + hcgateway_db are active
• HCGateway Android app has completed at least one sync (auto-syncs every 2h)
• Credentials stored in skills/amazfit-health-log/config.json

Execution#

Step 1: Verify container status#

bash

docker ps --filter "name=hcgateway" --format "{{.Names}}: {{.Status}}"

If containers are not running:

bash

sudo docker compose -f /home/docker/hcgateway/docker-compose.yml up -d

Step 2: Run the Python script#

For yesterday (default):

bash

python3 ~/.openclaw/workspace/skills/amazfit-health-log/scripts/fetch-health.py

For a specific date:

bash

python3 ~/.openclaw/workspace/skills/amazfit-health-log/scripts/fetch-health.py 2026-04-06

Step 3: Confirm output#

The script prints a summary and writes the note to:

text

<VAULT_ROOT>/30 Bereiche/Gesundheit/Logs/GTR3/YYYY-MM-DD.md

Output Format (Note)#

The generated note contains:

• Frontmatter: date, weekday, tags, source, created timestamp
• Summary table: steps, distance, sleep duration, resting HR, SpO2
• Sleep section: period, duration, stage breakdown table (Deep / REM / Light / Awake)
• Heart rate section: avg, min, max, resting HR
• SpO2 section: daily average
• Navigation links to previous and next day

Sleep Stage Decoding#

CodeStage1Awake4Light5Deep6REM

Troubleshooting#

No data for date:

• Check that Zepp App → Health Connect sync is enabled
• Open the HCGateway Android app and trigger a manual sync
• Data is only available for the last 30 days

Containers unreachable:

bash

sudo docker compose -f /home/docker/hcgateway/docker-compose.yml logs --tail=20

Changing credentials:

• Edit skills/amazfit-health-log/config.json
• Password changes invalidate all existing tokens (re-login required)

Cron Configuration (daily at 06:00)#

For automatic daily execution:

text

0 6 * * * python3 /home/openclaw/.openclaw/workspace/skills/amazfit-health-log/scripts/fetch-health.py

Data Sources#

TypeHCGateway EndpointSourceSteps/fetch/stepscom.huami.watch.hmwatchmanagerSleep/fetch/sleepSessioncom.huami.watch.hmwatchmanagerHeart Rate/fetch/heartRatecom.huami.watch.hmwatchmanagerResting HR/fetch/restingHeartRatecom.huami.watch.hmwatchmanagerSpO2/fetch/oxygenSaturationcom.huami.watch.hmwatchmanagerDistance/fetch/distancecom.huami.watch.hmwatchmanager