Garmin 健康数据分析 Skill 使用指南

用大白话告诉你怎么用 OpenClaw 聊天查询你的 Garmin 手表数据

一、这个 Skill 是干嘛的？

简单说，它让你可以用聊天的方式查看你的 Garmin 手表数据。

你有没有 Garmin 手表或手环？它每天记录你的睡眠、心率、运动、压力等数据。但这些数据都在 Garmin Connect App 里，想看的话得打开 App，点来点去。

有了这个 Skill，你只需要跟 OpenClaw 说一句话，比如：

  • “我昨晚睡得怎么样？”
  • “这周运动了几次？”
  • “我的心率恢复情况如何？”

OpenClaw 就会自动帮你查 Garmin 数据，然后用大白话告诉你结果。

它能查什么数据？

数据类型 说明 例子
🛏️ 睡眠 睡了多久、深睡浅睡比例、睡眠评分 “昨晚睡了几个小时？”
🔋 身体电量 Garmin 特有的恢复指标（0-100） “我今天身体电量多少？”
❤️ 心率 静息心率、最高最低心率 “我的心率正常吗？”
📈 HRV 心率变异性（恢复能力指标） “我的 HRV 趋势怎么样？”
🏃 运动记录 跑步、骑行、游泳等运动数据 “这周跑了多少公里？”
😰 压力值 全天压力水平 “今天压力大不大？”
📊 综合报告 所有指标的汇总 “给我看下这周的健康报告”

它还能生成图表！

除了文字回答，它还能生成漂亮的 HTML 图表，在浏览器里打开，一目了然。

二、如何安装这个 Skill

最简单的方式：一句话安装

直接跟 OpenClaw 说：

请安装 https://github.com/openclaw/skills/tree/main/skills/eversonl/garmin-health-analysis skill

OpenClaw 会自动帮你下载安装，完全不用动手！

Skill 地址

如果你想手动查看或分享，地址是：

1
https://github.com/openclaw/skills/tree/main/skills/eversonl/garmin-health-analysis

三、安装后的配置步骤

第一步：确认你有 Garmin 账号

你需要：

  1. 一块 Garmin 手表或手环
  2. Garmin Connect 账号（就是你在 Garmin App 登录的那个）

第二步：安装依赖

打开终端，输入：

1
pip3 install garminconnect

第三步：配置你的 Garmin 账号密码

有三种方式，选一种最方便的：

方式一：在 OpenClaw 配置文件里填写（推荐）

编辑配置文件 ~/.openclaw/openclaw.json，添加：

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "skills": {
    "entries": {
      "garmin-health-analysis": {
        "enabled": true,
        "env": {
          "GARMIN_EMAIL": "你的邮箱",
          "GARMIN_PASSWORD": "你的密码"
        }
      }
    }
  }
}

方式二：在 Skill 目录创建配置文件

1
cd ~/.openclaw/skills/garmin-health-analysis

创建 config.json 文件：

1
2
3
4
{
  "email": "你的邮箱",
  "password": "你的密码"
}

第四步：登录 Garmin 账号

在终端运行：

1
python3 scripts/garmin_auth.py login

登录成功后，会生成一个令牌文件，以后就不用再登录了。

检查登录状态：

1
python3 scripts/garmin_auth.py status

第五步：重启 OpenClaw

1
openclaw gateway restart

搞定！现在你可以开始跟 OpenClaw 聊你的健康数据了。

四、怎么提问？五个实际案例

下面是五个真实的对话例子，你可以直接照着问：

案例 1：查询睡眠质量

你问：

我昨晚睡得怎么样？

OpenClaw 回答（示例）：

你昨晚总共睡了 7小时23分钟，睡眠评分 82分（良好）。

  • 深睡：1小时45分钟
  • 浅睡：4小时12分钟
  • REM（做梦期）：1小时26分钟

整体睡眠质量不错！深睡比例正常，建议保持规律的作息时间。

案例 2：查看身体恢复状态

你问：

我今天的身体电量是多少？恢复得好吗？

OpenClaw 回答（示例）：

你今天的身体电量是 68（中等）。

昨晚充满 32 点，今早醒来时是 85 点，今天活动消耗了 17 点。

解读：

  • 75-100：精力充沛，可以高强度运动
  • 50-74：中等能量，适合常规活动 ← 你在这里
  • 25-49：电量不足，需要休息
  • 0-24：严重亏空，必须休息

建议今天做中等强度运动，不要过度训练。

案例 3：查看一周运动记录

你问：

这周我运动了几次？消耗了多少卡路里？

OpenClaw 回答（示例）：

这周你总共运动了 4 次，消耗 2,340 卡路里。

日期 运动类型 时长 卡路里
周一 跑步 45分钟 520
周三 骑行 60分钟 680
周五 游泳 30分钟 420
周日 跑步 35分钟 720

运动频率很好！建议继续保持，下周可以尝试增加一些力量训练。

案例 4：分析心率趋势

你问：

我最近的静息心率怎么样？有没有变好？

OpenClaw 回答（示例）：

你过去 30 天的静息心率平均是 62 bpm。

  • 最高：68 bpm（2月15日）
  • 最低：58 bpm（2月22日）
  • 趋势：略微下降 ✅

解读：

  • 运动员：40-60 bpm
  • 健康成年人：60-70 bpm ← 你在这里
  • 普通成年人：70-80 bpm

你的心率在健康范围内，而且有轻微下降趋势，说明心肺功能在进步！

案例 5：生成健康报告图表

你问：

帮我生成一份这个月的健康报告图表

OpenClaw 回答（示例）：

好的，正在为你生成健康报告图表…

然后它会自动在浏览器打开一个漂亮的 HTML 页面，包含：

  • 📊 睡眠趋势图（睡眠时长 + 评分曲线）
  • 🔋 身体电量图（带颜色标记的能量条）
  • ❤️ HRV 和静息心率趋势图
  • 🏃 运动汇总图（按类型和卡路里）

你可以直观地看到自己一个月的健康变化趋势。

五、常见问题

Q：登录失败怎么办？

  1. 检查邮箱密码是否正确
  2. 尝试在网页登录 Garmin Connect 确认账号正常
  3. 如果提示”请求过多”，等几分钟再试

Q：为什么有些数据查不到？

  • Body Battery 需要支持 HRV 的 Garmin 设备
  • 如果那天没戴手表，数据会缺失
  • 新账号历史数据可能有限

Q：数据安全吗？

  • 你的账号密码只存在你自己的电脑上
  • 数据只发送到 Garmin 官方服务器
  • 随时可以删除令牌文件来取消授权

六、总结

场景 怎么问
查睡眠 “我昨晚睡得好不好？”
查恢复 “身体电量多少？需要休息吗？”
查运动 “这周运动了几次？”
查心率 “我的心率正常吗？”
看图表 “帮我生成健康报告图表”

记住：就像跟朋友聊天一样问问题就行，OpenClaw 会帮你搞定剩下的！

创建日期：2026-02-28
Skill 地址：https://github.com/openclaw/skills/tree/main/skills/eversonl/garmin-health-analysis