ClawHub

Garmin Sync CN

Security

Garmin Connect 数据同步技能：通过浏览器自动化抓取当日健康数据（步数/心率/睡眠/压力/身体电池等）并写入本地和服务器数据库。当 OAuth 返回 403 时，优先使用用户已登录的 Chrome session 绕过限制，无需每次输入验证码。触发场景：'同步佳明数据'、'同步今天的佳明数据'、'抓取佳明实时数据'。

Install

openclaw skills install garmin-sync

Garmin Sync

通过浏览器自动化同步 Garmin Connect 当日健康数据。

核心流程

  1. 检查 session → 用 profile="user" 尝试已登录的 Chrome session
  2. 抓数据 → 直接从 Garmin Connect 每日摘要页面提取指标
  3. 写 DB → 更新本地 + 服务器 garmin.db
  4. git 同步 → 提交到两个 remote

Step 1：检查现有 Session

browser(action="tabs", profile="user")

检查是否有 garmin.cn 已登录的 tab：

  • 有 → 直接用 profile="user" 打开每日摘要页面
  • 无 → 启动 profile="openclaw" 执行完整登录流程

Step 2：导航到每日摘要

已登录时，直接导航：

browser(action="navigate", targetId="garmin", profile="user", url="https://connect.garmin.cn/app/daily-summary/10037590?date=YYYY-MM-DD")

Step 3：提取页面数据

用 JS 遍历 innerText，提取关键指标：

// 提取所有含数字的行
var text = document.body.innerText;
var lines = text.split('\n');

// 定位关键区块
var blocks = {};
['步数','心率','身体电量','压力','强度','楼层','睡眠','卡路里'].forEach(k => {
  var idx = text.indexOf(k);
  if (idx > -1) blocks[k] = text.substring(idx, idx+300);
});
JSON.stringify(blocks);  // 返回给 Python 处理

每日摘要页面数据定位（实测 ref）：

  • 步数: 14,509 — 下方紧跟"距离" 12.3 km
  • 心率: 55 bpm 静息 / 52 bpm 静止 / 168 bpm 最高
  • 身体电池: 18/100，+78 充能，-67 耗能
  • 压力: 25 平均 / 低 9时47分 / 中 4时6分 / 高 1时25分
  • 强度分钟: 110 中等 + 8 高强度，周目标 300
  • 楼层: 17 上 / 14 下

Step 4：写入数据库

data = {
    'date': 'YYYY-MM-DD',
    'steps': 14509, 'distance_km': 12.3, 'calories_kcal': 2713.0,
    'active_minutes': 118, 'resting_hr': 55, 'floors': 17.0,
    'stress_low': 587, 'stress_medium': 246, 'stress_high': 85, 'stress_avg': 25,
    'body_battery_start': 18, 'body_battery_end': 18,
    'body_battery_charged': 78, 'body_battery_drained': 67,
    'moderate_min': 110, 'vigorous_min': 8, 'intensity_goal': 300,
    'spo2_avg': 94, 'respiration': 18,
}

# 写入本地和服务器
dbs = [
    "/root/.openclaw/workspace/workplan-repo/projects/运动与健康/佳明数据/garmin.db",
    "ubuntu@124.221.34.26:/var/www/workplan-backend/projects/运动与健康/佳明数据/garmin.db"
]

Step 5：完整登录流程（如需 MFA）

当 session 失效时：

  1. 打开登录页

    browser(action="open", label="garmin", url="https://connect.garmin.cn/signin")

  2. JS 注入填表

    document.querySelector('#email').value = '634194250@qq.com';
document.querySelector('#password').value = 'Yjh199548';
Array.from(document.querySelectorAll('button')).find(b => b.textContent.includes('Sign In')).click();

  3. 等 MFA 页面（URL → /mfa），让用户输入验证码

  4. 注入验证码并提交

    document.getElementById('securityCode').value = 'XXXXXX';
Array.from(document.querySelectorAll('button')).find(b => b.textContent.trim() === 'Next').click();

  5. 等待跳转 /app/home，session 保持约 7 天

数据库 Schema

daily_summary: id, date, steps, distance_km, calories_kcal, active_minutes, resting_hr,
               floors, stress_low, stress_medium, stress_high, stress_avg,
               body_battery_start, body_battery_end, body_battery_charged, body_battery_drained,
               spo2_avg, spo2_low, respiration, hydration_ml, hydration_goal,
               moderate_min, vigorous_min, intensity_goal, highly_active_sec, created_at

activities: id, date, activity_type, distance_km, duration_min, created_at

快速命令

# 检查 session
browser(action="tabs", profile="user")

# 已登录 → 直接抓今天数据
browser(action="navigate", targetId="garmin", profile="user", url="https://connect.garmin.cn/app/daily-summary/10037590?date=2026-05-20")

# 提取数据（返回给 Python 处理）
JS: JSON.stringify(blocks) from innerText analysis

# 写入本地 + 服务器 DB
python3 scripts/sync_day.py YYYY-MM-DD steps distance_km calories active_minutes resting_hr floors

# git 同步
git add garmin.db && git commit -m "sync: YYYY-MM-DD 数据" && git push origin master && git push tencent master

注意事项

  • MFA: 用户提供验证码后立即注入，不要等待太久（验证码有时效）
  • 不要重复触发 login(): 会导致之前所有验证码失效，系统发新验证码给用户
  • session 有效期: Chrome session 登录后约 7 天有效
  • 压力时间转换: "9时47分" → 587 分钟（9×60+47）
  • 活跃分钟: active_minutes = moderate_min + vigorous_min（不是 total day active）
More in Security