（5883期）WHOOP Central – WHOOP 数据同步与分析中心

WHOOP 数据同步与分析中心 WHOOP Central 是一个用于访问 WHOOP 健身追踪数据的技能，支持获取睡眠、恢复分数、HRV、压力和锻炼数据，需通过 OAuth 2.0 认证。 使用说明 核心用法 WHOOP Central 是一个基于 Node.js 的命令行工具，用于通过 WHOOP Developer API v2 获取用户的健身和健康数据。主要功能包括： 数据获取：支持获取恢复分数（0-100%）、HRV、静息心率、血氧、睡眠阶段（REM/深睡/浅睡）、睡眠效率、日常压力（0-21）、卡路里消耗、锻炼详情等 快速命令：提供 today.js（当日快照）、summary.js（每日汇总）、recovery.js、sleep.js、strain.js、workouts.js 等独立脚本 历史数据导入：支持批量导入到本地日志目录 JSON 输出：支持 --json 和 --jsonl 格式，便于与其他工具集成 认证流程 采用 OAuth 2.0 认证，推荐通过 Postman 完成首次授权： 在 WHOOP Developer Dashboard 创建应用 配置 Redirect URI（推荐 https://oauth.pstmn.io/v1/browser-callback） 请求 scope 需包含 offline 以获取 refresh_token 保存 accesstoken 和 refreshtoken 到 ~/.clawdbot/whoop/token.json 支持自动刷新令牌 显著优点 数据维度丰富：涵盖恢复、睡眠、压力、锻炼四大核心维度，数据粒度细（含睡眠阶段、心率区间等） 自动化友好：支持 JSON/JSONL 输出，便于脚本化和数据管道集成 令牌自动管理：内置自动刷新机制，无需手动维护 灵活的时间过滤：支持 --days、--since、--start/--end 等多种时间范围指定 官方 API 支持：基于 WHOOP 官方 Developer API v2，数据来源可靠 潜在缺点与局限性 认证复杂度高：WHOOP OAuth 端点对浏览器 User-Agent 敏感，可能阻断请求；需要熟悉 OAuth 2.0 流程 依赖外部工具：推荐依赖 Postman 完成首次认证，纯本地流程（auth.js）可能对部分账户失效 自托管 HTTPS 限制：本地回调需处理自签名证书 TLS 警告 Scope 限制：部分账户可能因会员状态或测试用户限制无法授权特定 scope 无实时数据：API 数据存在延迟，非实时流式数据 需自建应用：不预置客户端凭证，每个用户/团队需自行创建 WHOOP Developer 应用 适合人群 量化自我（Quantified Self）爱好者：希望自动化追踪和分析 WHOOP 数据 开发者和数据工程师：需要将 WHOOP 数据集成到个人数据管道或健康分析系统 健身教练和运动员：需要批量导出历史数据进行分析或报告生成 WHOOP 重度用户：已习惯 WHOOP 生态系统，希望突破官方 App 的数据查看限制 常规风险 | 风险类型 | 说明 | 缓解建议 ||---------|------|---------|| OAuth 令牌泄露 | token.json 包含 accesstoken 和 refreshtoken，泄露可导致账户数据被访问 | 确保 ~/.clawdbot/whoop/ 目录权限严格（600），勿提交到版本控制 || API 限流 | 高频调用可能触发 WHOOP 速率限制 | 合理使用 --limit 和缓存机制，避免循环高频调用 || 数据隐私 | 健康数据（睡眠、HRV、锻炼）属敏感个人信息 | 确保本地存储加密，传输使用 HTTPS || 令牌失效 | WHOOP refresh_token 轮换机制可能导致意外失效 | 保留备用认证流程，定期检查 verify.js || 第三方依赖 | 依赖 WHOOP API 可用性和策略变更 | 关注 WHOOP Developer 公告，做好数据本地备份 | 技术依赖 Node.js 18+（ESM 模块） openssl（仅本地 HTTPS 认证流程需要） 原始说明 WHOOP Central - OAuth + scripts to fetch WHOOP data (sleep, recovery, strain, workouts). Use when user asks about their sleep, recovery score, HRV, strain, or workout data.