← Back to Skills Marketplace
77
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install amazfit-health-log
Description
Fetches Amazfit GTR3 health data from HCGateway and writes a daily Obsidian log note. Use when user says "health log", "GTR3 data", "write health data", "fet...
README (SKILL.md)
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_dbare 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:
\x3CVAULT_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
| Code | Stage |
|---|---|
| 1 | Awake |
| 4 | Light |
| 5 | Deep |
| 6 | REM |
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
| Type | HCGateway Endpoint | Source |
|---|---|---|
| Steps | /fetch/steps |
com.huami.watch.hmwatchmanager |
| Sleep | /fetch/sleepSession |
com.huami.watch.hmwatchmanager |
| Heart Rate | /fetch/heartRate |
com.huami.watch.hmwatchmanager |
| Resting HR | /fetch/restingHeartRate |
com.huami.watch.hmwatchmanager |
| SpO2 | /fetch/oxygenSaturation |
com.huami.watch.hmwatchmanager |
| Distance | /fetch/distance |
com.huami.watch.hmwatchmanager |
Usage Guidance
This skill appears to do exactly what it says: authenticate to a HCGateway instance, gather Amazfit metrics, and write a daily Markdown note into your Obsidian vault. Before installing or enabling it, consider the following:
- Config/credentials: You must provide base_url, username and password in skills/amazfit-health-log/config.json. Those credentials are stored as plaintext in that file by design — if you are concerned about storing secrets on disk, put the file on an encrypted partition or use a secrets manager and adjust the script.
- Verify base_url: Ensure the configured base_url points to a trusted local HCGateway (e.g., http://127.0.0.1:6644). If you change base_url to a remote host, the script will send your HCGateway credentials to that remote host — review that risk carefully.
- File writes: The script will create the configured vault/log directory and write daily .md files. Confirm the vault_path/log_dir are correct to avoid overwriting or creating files in an unexpected location.
- Privileged actions in docs: The troubleshooting steps suggest running sudo docker compose with an absolute path (/home/docker/hcgateway/docker-compose.yml). That command is related to starting a local HCGateway container but is system-level and user-specific — do not run such commands unless you understand them and the paths match your system.
- Paths in docs: The README examples use different home paths (~/ vs /home/openclaw). Update cron and paths to match your environment before enabling automated runs.
- Audit and run locally: If you want extra assurance, inspect scripts/fetch-health.py (already included) and run it manually the first time to confirm behavior. Running it in a user account with limited permissions is a good precaution.
If you accept these tradeoffs (local HCGateway usage, plaintext local config), the skill is coherent and suitable for the described task.
Capability Analysis
Type: OpenClaw Skill
Name: amazfit-health-log
Version: 1.0.1
The skill automates fetching Amazfit GTR3 health data from a local HCGateway and writing it to an Obsidian vault. While the Python script (scripts/fetch-health.py) appears to perform its stated task using standard libraries and lacks evidence of intentional malice, the SKILL.md instructions direct the AI agent to perform high-risk actions, including executing 'sudo docker' commands for service management. These risky capabilities, combined with the requirement for broad filesystem and network access to handle credentials and logs, represent a significant attack surface for potential prompt-injection or privilege escalation, placing it in the suspicious category.
Capability Assessment
Purpose & Capability
The name/description (Amazfit → HCGateway → Obsidian note) matches the included files. The script authenticates to a configured base_url and calls /api/v2/fetch/* endpoints, then writes a markdown file into the user's vault. Requested config fields (base_url, username, password, vault_path, log_dir) are exactly what this functionality needs.
Instruction Scope
SKILL.md instructions stay within the stated purpose (verify Docker containers, run the Python script, optionally enable a cron). Two points to notice: (1) the troubleshooting steps advise running 'sudo docker compose -f /home/docker/hcgateway/docker-compose.yml up -d' — a specific absolute path and use of sudo that may not match a user's install and implies privileged system actions; (2) cron and example paths in the docs use different home paths (/home/openclaw vs ~/.openclaw), which are user-specific and may need adjustment. Otherwise the runtime steps only read the skill's config, call the local HCGateway, and write files to the configured vault.
Install Mechanism
No install spec; this is instruction + a single Python script using standard-library modules (urllib, zoneinfo). Nothing is downloaded from external URLs and no archives are extracted, so install risk is low.
Credentials
The skill requests credentials via a config.json (base_url, username, password). That is proportionate to authenticating to HCGateway. Be aware the credentials are intended to be stored in plaintext in skills/.../config.json per the docs; this is expected for a local utility but has confidentiality implications. There are no other unrelated environment variables or secrets requested.
Persistence & Privilege
The skill is not force-installed (always:false) and does not modify other skills or global agent settings. It can be invoked autonomously (disable-model-invocation:false) which is the platform default; that alone is not a red flag given the skill's limited scope and local-only network usage.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install amazfit-health-log - After installation, invoke the skill by name or use
/amazfit-health-log - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated config.example.json (configuration example).
- No code or documentation changes in the skill logic or usage.
- Version remains at 1.0.0 in documentation.
v1.0.0
amazfit-health-log 1.0.0 (initial release)
- Automatically fetches daily health data from an Amazfit GTR3 via HCGateway.
- Writes a structured Obsidian note summarizing steps, sleep, heart rate, SpO2, and distance.
- Supports triggering by user command or daily cron (default 06:00).
- Includes troubleshooting steps and detailed output format.
- Requires running HCGateway containers and pre-configured credentials.
Metadata
Frequently Asked Questions
What is Amazfit Health Log?
Fetches Amazfit GTR3 health data from HCGateway and writes a daily Obsidian log note. Use when user says "health log", "GTR3 data", "write health data", "fet... It is an AI Agent Skill for Claude Code / OpenClaw, with 77 downloads so far.
How do I install Amazfit Health Log?
Run "/install amazfit-health-log" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Amazfit Health Log free?
Yes, Amazfit Health Log is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Amazfit Health Log support?
Amazfit Health Log is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Amazfit Health Log?
It is built and maintained by Sanweb (@sanwebgit); the current version is v1.0.1.
More Skills