Withings家庭健康数据

技能简介

连接Withings API，为多个家庭成员获取智能设备的健康数据，包括体重、体脂、肌肉量、骨量、水分、日常活动及睡眠质量等指标。

能做什么

• 查询个人或家庭成员的体重历史与变化趋势
• 获取身体成分分析（脂肪比例、肌肉质量、骨骼质量、水合状态）
• 查看每日活动数据（步数、距离、消耗卡路里）
• 读取睡眠监测结果（时长、质量、深睡、REM阶段）
• 支持多用户独立认证，每位成员拥有专属令牌文件

使用说明

前置准备：创建Withings开发者应用

1. 访问 Withings开发者门户 注册账号
2. 进入「My Apps」→「Create an Application」
3. 填写应用信息，回调URL设为 http://localhost:18081
4. 获取Client ID和Client Secret

安装与配置

# 设置环境变量
export WITHINGS_CLIENT_ID="your_client_id"
export WITHINGS_CLIENT_SECRET="your_client_secret"

# 或在 ~/.openclaw/withings-family/.env 文件中配置
WITHINGS_CLIENT_ID=your_client_id
WITHINGS_CLIENT_SECRET=your_client_secret

首次认证（每位成员需单独执行）

# 自动OAuth（推荐）
python3 scripts/withings_oauth_local.py alice

# 或手动OAuth
python3 scripts/withings.py alice auth
# 用户访问返回的URL，获取授权码后执行：
python3 scripts/withings.py alice auth YOUR_CODE

查询数据

python3 scripts/withings.py alice weight    # 体重数据
python3 scripts/withings.py bob sleep       # 睡眠数据
python3 scripts/withings.py charlie activity # 活动数据

输入与输出

见下方输入与输出表格。

风险提示

• 需要妥善保管Client Secret，避免泄露导致账户风险
• OAuth令牌存储于本地文件，需确保文件权限安全（建议600）
• API调用受Withings速率限制，频繁请求可能触发限流
• 健康数据涉及个人隐私，共享设备时需注意成员授权边界

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/odrobnik/withings-family/SKILL.md
来源类型：GitHub仓库