← Back to Skills Marketplace
Garmin Connect Sync (国际→国内)
by
BruceTangc
· GitHub ↗
· v2.0.0
· MIT-0
40
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install garmin-connect-sync
Description
佳明国际账号数据同步到国内账号（基于 garminconnect 开源库）
README (SKILL.md)
Garmin 国际→国内账号同步技能 v2.0
基于 python-garminconnect 开源库， 从 Garmin Connect International 读取活动数据，下载 FIT 文件后上传到 Garmin Connect China。
功能
| 功能 | 命令 | 说明 |
|---|---|---|
| 🔄 同步 | sync |
执行一次完整同步（读取国际版→下载FIT→上传国内版） |
| 📊 状态 | status |
查看同步状态和统计 |
| 📋 列表 | list |
查看最近活动记录 |
| 🔧 认证测试 | auth-test |
测试国际版和国内版账号认证 |
使用方式
// 完整同步（最近7天）
sync()
// 同步最近30天
sync({ days: 30 })
// 查看同步状态
status()
// 列出最近活动
list()
// 测试认证
auth-test()
同步原理
- 🔐 登录国际版 Garmin Connect，获取活动列表
- ⬇️ 下载每条活动的原始 FIT 文件
- 📤 登录国内版 Garmin Connect，上传 FIT 文件
- 💾 记录已同步的活动 ID，避免重复
环境变量配置
| 变量 | 必填 | 说明 |
|---|---|---|
GARMIN_INTL_USERNAME |
✅ | 国际版 Garmin 账号（邮箱） |
GARMIN_INTL_PASSWORD |
✅ | 国际版 Garmin 密码 |
GARMIN_CN_USERNAME |
✅ | 国内版 Garmin 账号（邮箱/手机） |
GARMIN_CN_PASSWORD |
✅ | 国内版 Garmin 密码 |
GARMIN_SYNC_DIR |
❌ | 数据存储目录（默认 ~/.garmin-sync） |
⚠️ 注意事项
- API 限流: Garmin API 有请求频率限制，同步间隔会自动处理
- 重复检测: 已同步的活动会自动跳过，不会重复上传
- FIT 缓存: 下载的 FIT 文件保存在本地，可定期清理
- 首次使用: 建议先用
auth-test验证账号配置是否正确
版本历史
v2.0.0 (2026-04-29)
- 全面重写，基于 python-garminconnect 真实 API
- 支持完整的认证流程（含 OAuth token 持久化）
- 支持 FIT 文件下载 + 国内版上传
- 支持活动去重和状态记录
v1.0.0 (2026-04-16)
- 初始版本（模拟实现，未对接真实 API）
Usage Guidance
Install only if you are comfortable giving the agent access to Garmin credentials or tokens and personal fitness history. Before first use, confirm exactly which accounts are accessed, where FIT files or tokens are stored, how to delete cached data, and require explicit confirmation before any download, upload, or cross-account sync.
Capability Tags
Capability Assessment
Purpose & Capability
The stated behavior of transferring Garmin activity data between accounts coherently explains credential use, OAuth tokens, downloads, uploads, and FIT file handling, but those are sensitive health/account data flows that need explicit disclosure.
Instruction Scope
The reported trigger wording is broad for common Garmin, syncing, and watch-related discussions, which raises unintended-activation risk for a credential-backed workflow unless the skill requires explicit user confirmation before login, download, upload, or writes.
Install Mechanism
No concerning install-time behavior, package hooks, background setup, or hidden installer actions were supplied or found in the available workspace review.
Credentials
Network account access and local FIT files are proportionate for Garmin account migration or synchronization, but users should understand that personal fitness history may be read, cached, and transmitted between services.
Persistence & Privilege
The scanner-reported local caching of FIT files and token/credential-backed operations create a persistence and privacy concern because the supplied materials do not show clear retention, deletion, or local storage guidance.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install garmin-connect-sync - After installation, invoke the skill by name or use
/garmin-connect-sync - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
基于 python-garminconnect 的真实 Garmin API 同步，支持国际版→国内版 FIT 文件上传
Metadata
Frequently Asked Questions
What is Garmin Connect Sync (国际→国内)?
佳明国际账号数据同步到国内账号（基于 garminconnect 开源库）. It is an AI Agent Skill for Claude Code / OpenClaw, with 40 downloads so far.
How do I install Garmin Connect Sync (国际→国内)?
Run "/install garmin-connect-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Garmin Connect Sync (国际→国内) free?
Yes, Garmin Connect Sync (国际→国内) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Garmin Connect Sync (国际→国内) support?
Garmin Connect Sync (国际→国内) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Garmin Connect Sync (国际→国内)?
It is built and maintained by BruceTangc (@brucetangc); the current version is v2.0.0.
More Skills