← Back to Skills Marketplace
193
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install garmin-connect-cn
Description
读取 Garmin Connect 手表/设备数据。 触发场景： - "今天走了多少步" - "昨晚睡眠怎么样" - "最近有什么运动" - "心率怎么样" - "这周跑了多少次" - 查询任意日期的运动、睡眠、心率等健康数据
README (SKILL.md)
Garmin Connect 数据查询
前置要求
- JWT Token（从浏览器获取，有效期约1个月）
- Python 3.8+
快速查询
python3 scripts/query.py \x3Cjwt_token> [日期 YYYY-MM-DD]
不传日期默认查今天。
数据类型
| 查询 | 字段 |
|---|---|
| 步数 | totalSteps |
| 距离(km) | totalDistance / 1000 |
| 卡路里 | activeKilocalories |
| 爬楼层数 | totalFloorsAscending |
| 睡眠时长 | sleepingDuration |
API 端点
详见 references/api.md
Token 获取
- 浏览器打开 https://connect.garmin.cn 并登录
- F12 → Application → Cookies →
connect.garmin.cn - 找到
JWT_WEB，复制 Value（eyJ...开头）
注意
JWT 过期后需重新获取。每次查询前检查 Token 有效性。
Usage Guidance
This skill appears internally consistent and implements exactly what it says: it queries Garmin Connect APIs using a browser-extracted JWT. Before installing/running it, remember: (1) the JWT is a sensitive bearer token — treat it like a password and do not share it; (2) follow the README steps locally and inspect the included scripts yourself before running; (3) the scripts print data to stdout only, but if you store the token in an environment variable or a file, be careful not to commit or share it; (4) the scripts include a hard-coded default userId from the author — you can ignore that and let the code fetch your userId via the API. If you are uncomfortable extracting tokens from your browser, do not use the skill.
Capability Analysis
Type: OpenClaw Skill
Name: garmin-connect-cn
Version: 1.0.0
The skill is designed to query health and activity data from the Garmin Connect China API (connect.garmin.cn) using a user-provided JWT token. The scripts (scripts/query.py and scripts/activities.py) perform legitimate API requests to official Garmin endpoints and print the results to the console. While there are hardcoded default user IDs and example email addresses in the documentation and scripts (e.g., user ID 116181268), these appear to be developer artifacts or placeholders rather than malicious indicators. No evidence of data exfiltration, unauthorized network calls, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description match the included code and docs. The scripts call Garmin Connect endpoints and require a JWT from the user's Garmin session cookie — this is coherent for a client that reads personal Garmin data.
Instruction Scope
SKILL.md and references explicitly instruct the user to extract the JWT_WEB cookie from the browser and pass it to the Python scripts. That is necessary for the described functionality, but it involves handling a sensitive bearer token; the docs warn about token secrecy. No instructions ask the agent to read unrelated files or exfiltrate data to other endpoints.
Install Mechanism
This is instruction-only (no install spec). The project includes small Python scripts and the README advises installing the 'requests' package via pip. No downloads from arbitrary URLs or archive extraction steps are present.
Credentials
The only sensitive credential the skill needs is the Garmin JWT token (user-provided). The metadata declares no required env vars, though README suggests an optional GARMIN_JWT env var. No unrelated credentials or secrets are requested. Minor oddity: scripts use a hard-coded default userId ('116181268') when none is provided, which is unnecessary and could be confusing.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system-wide configuration, and does not persist credentials. It only runs the included scripts when invoked.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install garmin-connect-cn - After installation, invoke the skill by name or use
/garmin-connect-cn - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: steps/distance/calories/sleep/activities
Metadata
Frequently Asked Questions
What is Garmin Connect Data Query?
读取 Garmin Connect 手表/设备数据。 触发场景： - "今天走了多少步" - "昨晚睡眠怎么样" - "最近有什么运动" - "心率怎么样" - "这周跑了多少次" - 查询任意日期的运动、睡眠、心率等健康数据. It is an AI Agent Skill for Claude Code / OpenClaw, with 193 downloads so far.
How do I install Garmin Connect Data Query?
Run "/install garmin-connect-cn" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Garmin Connect Data Query free?
Yes, Garmin Connect Data Query is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Garmin Connect Data Query support?
Garmin Connect Data Query is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Garmin Connect Data Query?
It is built and maintained by tcyxk (@tcyxk); the current version is v1.0.0.
More Skills