核心功能
Garmin Connect Skill 用于将 Garmin 智能穿戴设备采集的健康数据同步到本地 Markdown 文件。支持的数据维度包括：睡眠时长与质量、日常活动（步数、消耗卡路里）、静息/实时心率、全天压力指数、Body Battery 能量储备、心率变异性（HRV）、血氧饱和度（SpO2）以及体重记录。
使用方法
首次使用需运行 --setup 完成一次性认证，密码通过 getpass 交互输入，不进入命令历史或进程列表。认证成功后 OAuth Token 缓存约一年，后续同步无需重复登录。支持同步今日数据、指定日期或过去 N 天数据。建议配置 OpenClaw 的 cron 工具实现每日自动同步。
显著优点
- 数据主权：健康数据以 Markdown 格式本地化存储，便于长期归档与版本控制
- 零依赖维护：使用
uv管理 Python 环境，自动处理garminconnect和cloudscraper依赖，无需手动 pip - 安全设计：密码仅用于一次性获取 Token，运行期完全不接触明文凭证；Token 隔离存储于
~/.garminconnect/ - 多维度整合：单 skill 覆盖 Garmin 生态核心健康指标，减少多源数据整合成本
潜在局限
- 非官方 API：依赖社区逆向的
garminconnect库，存在接口变动导致同步失败的风险 - Token 有效期：约一年需重新认证，长期无人维护可能中断自动化流程
- 云依赖：需 Garmin 云端服务可用，本地离线使用受限
- 数据粒度：导出为 Markdown 后丧失原始秒级时序数据，适合日记式回顾而非科研级分析
适合人群
Garmin 设备深度用户、量化自我（Quantified Self）爱好者、希望通过 Markdown 管理个人健康档案的隐私敏感型用户，以及需要每日健康简报自动化生成的效率工具使用者。
常规风险
- Garmin 官方可能调整登录机制或反爬虫策略，导致依赖的
cloudscraper失效 - 长期存储的 Token 文件若被恶意程序读取，可访问用户健康数据
- 自动化 cron 任务若配置在共享环境，可能暴露缓存目录权限