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

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

If containers are not running:

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

Step 2: Run the Python script

For yesterday (default):

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

For a specific date:

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:

<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

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:

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:

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

Data Sources