Garmin数据同步

技能简介

该技能为Clawdbot提供Garmin Connect数据同步能力，通过OAuth安全认证获取用户的运动、睡眠、心率等健康数据，每5分钟自动更新并本地缓存，方便快速查询。

能做什么

• 同步每日活动数据：步数、静息心率、卡路里消耗、活跃时长、移动距离
• 获取睡眠分析：总时长、睡眠质量评分、深睡/浅睡/REM各阶段分布
• 记录近期锻炼：跑步、骑行等活动类型、距离、时长、心率区间
• 本地JSON缓存，避免频繁请求Garmin服务器
• 支持多用户配置，各自独立存储会话与缓存

使用说明

1. 安装依赖
   pip install -r requirements.txt
2. OAuth认证（一次性）
   python3 scripts/garmin-auth.py your-email@gmail.com your-password
   会话保存至~/.garth/session.json，纯本地存储
3. 测试同步
   python3 scripts/garmin-sync.py
4. 设置定时任务
   添加crontab：*/5 * * * * /home/user/garmin-connect-clawdbot/scripts/garmin-cron.sh
5. 在Clawdbot中调用

   from scripts.garmin_formatter import format_all, get_as_dict
   print(format_all())
   data = get_as_dict()
   print(f"Steps: {data['summary']['steps']:,}")

输入与输出

见下方输入与输出表格。

风险提示

• 需关闭Garmin账号两步验证或使用应用专用密码
• 频繁请求可能触发Garmin服务器限流，建议保持5分钟间隔
• OAuth凭证存储于本地文件，注意文件权限保护
• 设备需先同步至Garmin Connect云端，本技能才能获取最新数据

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/godsboy/garmin-connect-fixed/SKILL.md
来源类型：GitHub仓库