Garmin数据同步 · garmin-connect-fixed

技能简介

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

业务背景

面向健康管理场景，帮助业务人员快速集成Garmin运动数据。通过OAuth安全授权自动获取用户步数、心率、睡眠及锻炼记录，每5分钟更新并本地缓存，既避免频繁调用第三方接口，又能随时响应内部查询需求，降低健康类应用的数据对接门槛。

落地案例：某企业员工福利平台需展示员工运动达标情况。运营人员在Clawdbot中配置Garmin账号后，系统自动拉取当日步数、卡路里消耗及睡眠质量评分，生成可视化日报。员工打开内网页面即可查看个人健康摘要，HR团队也能批量导出汇总数据用于季度健康激励活动，无需手动整理多源数据。

能做什么

• 同步每日活动数据：步数、静息心率、卡路里消耗、活跃时长、移动距离
• 获取睡眠分析：总时长、睡眠质量评分、深睡/浅睡/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仓库