Garmin Connect Skill 是一个专为 Clawdbot 生态设计的集成工具，旨在实现 Garmin 健身设备与智能助手之间的无缝数据同步。通过 OAuth 安全认证机制，该技能每5分钟自动从 Garmin Connect 平台抓取用户的日常活动、睡眠和运动数据，并将其缓存至本地 JSON 文件。所有流程均在用户本地完成，无需上传敏感信息到第三方服务器，确保了隐私与安全。开发者可通过简单的 Python 脚本调用这些结构化数据，轻松将其整合进自动化工作流或健康监测系统中。该工具特别适合需要实时监控个人健康指标并触发特定响应的自动化场景，例如根据步数变化调整提醒策略，或在深度睡眠不足时启动放松程序。 整个系统采用模块化设计，包含多个独立脚本组件：`garmin-auth.py` 用于一次性 OAuth 授权登录；`garmin-sync.py` 负责定时拉取最新数据并更新缓存；`garmin-formatter.py` 则提供格式化输出功能，便于在终端或日志中展示可读性强的结果。此外，项目支持自定义缓存路径和多用户配置，增强了灵活性和可扩展性。依赖项清晰列于 `requirements.txt` 文件中，安装简便。对于希望将 Garmin 穿戴设备数据接入自动化平台的开发者而言，这是一个轻量、高效且完全本地化的解决方案。
核心功能特点
- 基于 OAuth 的安全认证，无需存储密码，保障账户隐私
- 每5分钟自动同步一次数据，支持实时获取最新健身信息
- 全面覆盖步数、心率、卡路里、距离、睡眠质量及各类运动记录
- 本地 JSON 缓存机制，提升读取速度并支持离线访问
- 易于集成进 Clawdbot 脚本体系，提供格式化和原始数据接口
- 支持多用户环境部署，可自定义缓存路径和定时任务
适用场景
该工具最典型的应用场景是构建个人健康管理自动化系统。例如，用户可以在每日早晨通过 Clawdbot 查询前一天的睡眠时长与质量，若检测到深度睡眠低于设定阈值，则自动发送一条鼓励早睡的消息；反之，若步数达标且睡眠良好，则可触发奖励机制，如播放一首激励歌曲或更新成就徽章。这种细粒度的反馈循环显著提升了健康行为的持续性与积极性。另一个常见用例是将 Garmin 数据用于家庭共享场景——父母可为子女设置每日步数目标，当孩子达到要求时，Clawdbot 会自动通知家长并给予虚拟积分，从而将可穿戴设备的数据转化为正向激励机制。 在企业内部，该集成也可服务于员工 wellness 计划。人力资源部门可通过定期汇总团队成员的运动数据（如平均活跃分钟数、静息心率趋势），生成匿名报告以评估整体健康状况，并据此优化办公环境或组织团建活动。此外，结合其他智能家居设备，Garmin 数据还能驱动更复杂的自动化链条：比如当系统识别用户处于高强度训练后，自动调低室内温度并开启空气净化器；或者在夜间浅睡阶段频繁觉醒时，联动灯光系统切换为柔和模式，帮助用户恢复更好的睡眠状态。这些高级应用充分展示了 Garmin Connect Skill 在连接物理世界与数字自动化之间的桥梁作用。