每日自动获取 WHOOP 恢复/睡眠/压力数据,生成个性化晨间健康建议,适合追求数据驱动训练的运动员和健身爱好者。
说明:
## 核心用法
`whoop-morning` 是一个与 WHOOP 可穿戴设备深度集成的自动化技能,每日清晨自动拉取用户的恢复指数(Recovery)、睡眠质量(Sleep)及周期压力值(Cycle/Strain)三大核心指标,并基于算法生成当日的运动与恢复建议。
### 显著优点
1. **数据闭环自动化**:无需手动打开 WHOOP App,Cron 定时任务即可将关键生理指标推送至用户终端,实现「零摩擦」晨间健康简报。
2. **官方 OAuth2 认证**:采用 WHOOP 官方认证流程(`offline` + `read:recovery`/`read:sleep`/`read:cycles`/`read:profile` 权限),数据传输全程加密,符合现代 API 安全标准。
3. **Token 自动刷新机制**:内置 Refresh Token 轮换处理,减少手动重新授权频率。
4. **高度可定制**:用户可自由配置 Cron 触发时间,输出格式易于集成至 Gateway 消息系统或其他自动化工作流。
### 潜在缺点与局限性
– **权限范围较窄**:仅支持只读权限,无法写入或修改 WHOOP 数据,不具备反向控制设备的能力。
– **Token 并发风险**:WHOOP 会轮换 Refresh Token,若多实例并行运行可能导致授权失效,需手动排查并重新执行 `whoop-auth`。
– **API 稳定性依赖**:WHOOP 官方 API 字段或可用性可能变更,存在 401/400 错误导致服务中断的风险。
– **硬件绑定**:功能完全依赖 WHOOP 可穿戴设备,无设备用户无法使用。
– **地域与账号限制**:需 WHOOP 订阅会员资格,部分地区或企业账号可能存在 API 访问限制。
### 适合人群
– 已持有 WHOOP 3.0/4.0 设备的运动员、CrossFit 爱好者、耐力运动训练者
– 追求 HRV(心率变异性)指导训练的量化健身人群
– 需要自动化晨间报告以减少决策疲劳的高效能用户
– 已部署 Clawdbot/Gateway 自动化基础设施的技术爱好者
### 常规风险
– **OAuth Token 泄露**:`WHOOP_CLIENT_ID`、`WHOOP_CLIENT_SECRET` 及 `WHOOP_REFRESH_TOKEN` 存储于本地 `~/.clawdbot/.env`,需确保文件权限严格限制(建议 `chmod 600`),避免容器或多用户环境泄露。
– **授权范围误配置**:若 scopes 遗漏 `offline`,将无法获取 Refresh Token,导致每日需手动重新授权。
– **API 限流与封号**:高频调用 WHOOP API 可能触发速率限制,建议合理设置 Cron 间隔(如每日 1 次)。
– **健康建议非医疗级**:算法建议基于通用运动科学,不构成医疗诊断,伤病恢复期用户应咨询专业医师。









