withings-health

此技能允许您与用户的Withings账户交互，从Withings设备（智能体重秤、睡眠分析仪、活动追踪器等）获取全面的健康指标。

使用此技能的时机

当用户出现以下情况时，使用此技能：

• 询问其体重或体重历史记录
• 想要查看其身体成分（脂肪百分比、肌肉量、骨量、水分含量）
• 请求其日常活动数据（步数、距离、消耗的卡路里）
• 询问其睡眠数据（时长、质量、深度睡眠、快速眼动睡眠）
• 提及"Withings"或任何Withings设备（Body+、Sleep Analyzer、ScanWatch等）
• 希望追踪其长期健康进展

设置：创建Withings开发者应用

在使用此技能之前，您需要创建一个免费的Withings开发者应用以获取您的API凭证。

步骤一：创建 Withings 开发者账户

1. 前往Withings 开发者门户
2. 点击注册或登录如果您已有 Withings 账户
3. 接受开发者服务条款

步骤二：创建您的应用程序

1. 导航至我的应用→创建应用
2. 填写应用详情：
   • 应用名称：选择一个名称（例如："我的 Clawdbot 健康"）
   • 描述：简要说明您的使用场景
   • 联系邮箱：您的电子邮箱地址
   • 回调网址：http://localhost:8080（OAuth 所需）
   • 应用类型：选择"个人使用"或合适的类型
3. 提交申请

步骤三：获取您的凭据

创建应用后：

1. 前往我的应用并选择您的应用
2. 您将找到：
   • 客户端ID→ 设置为WITHINGS_CLIENT_ID环境变量
   • 客户端密钥→ 设置为WITHINGS_CLIENT_SECRET环境变量

步骤四：配置环境变量

将这些添加到您的 Clawdbot 环境中：

export WITHINGS_CLIENT_ID="your_client_id_here"
export WITHINGS_CLIENT_SECRET="your_client_secret_here"

或者在技能目录中创建一个.env文件（此文件将被 git 忽略）：

WITHINGS_CLIENT_ID=your_client_id_here
WITHINGS_CLIENT_SECRET=your_client_secret_here

配置

该技能使用一个位于{baseDir}目录下的wrapper.js脚本。

在任何数据检索之前，检查用户是否已通过身份验证。如果错误信息提及“未找到令牌”，请引导用户完成初始身份验证流程。

可用命令

1. 身份验证

首次设置 - 生成 OAuth URL：

node {baseDir}/wrapper.js auth

用户访问该URL并获取授权码后：

node {baseDir}/wrapper.js auth YOUR_CODE_HERE

2. 获取体重

检索最新的体重测量数据：

node {baseDir}/wrapper.js weight

以JSON格式返回最近的5个体重记录。

示例输出：

[
  { "date": "2026-01-17T08:30:00.000Z", "weight": "75.40 kg" },
  { "date": "2026-01-16T08:15:00.000Z", "weight": "75.65 kg" }
]

3. 获取身体成分

检索全面的身体指标（脂肪、肌肉、骨骼、水分、BMI）：

node {baseDir}/wrapper.js body

返回最近的5次身体成分测量结果。

示例输出：

[
  {
    "date": "2026-01-17T08:30:00.000Z",
    "weight": "75.40 kg",
    "fat_percent": "18.5%",
    "fat_mass": "13.95 kg",
    "muscle_mass": "35.20 kg",
    "bone_mass": "3.10 kg",
    "hydration": "55.2%"
  }
]

4. 获取活动

获取每日活动数据（步数、距离、卡路里）：

node {baseDir}/wrapper.js activity

可选指定天数（默认：7天）：

node {baseDir}/wrapper.js activity 30

示例输出：

[
  {
    "date": "2026-01-17",
    "steps": 8542,
    "distance": "6.23 km",
    "calories": 2150,
    "active_calories": 450,
    "soft_activity": "45 min",
    "moderate_activity": "22 min",
    "intense_activity": "8 min"
  }
]

5. 获取睡眠数据

获取睡眠数据和睡眠质量：

node {baseDir}/wrapper.js sleep

可选指定天数（默认：7天）：

node {baseDir}/wrapper.js sleep 14

示例输出：

[
  {
    "date": "2026-01-17",
    "start": "23:15",
    "end": "07:30",
    "duration": "8h 15min",
    "deep_sleep": "1h 45min",
    "light_sleep": "4h 30min",
    "rem_sleep": "1h 30min",
    "awake": "30min",
    "sleep_score": 82
  }
]

错误处理

常见错误及解决方法：

备注

• 令牌过期时会自动刷新
• 使用的Withings API权限范围：user.metrics,user.activity
• 数据可用性取决于用户拥有的Withings设备类型
• 部分指标（如身体成分）需要兼容的智能秤设备