核心用法
whoop-cli 是一款非官方 WHOOP 健康数据命令行工具，专为注重隐私和自动化的用户设计。核心工作流分为三步：认证检查（whoop auth status）、日常数据拉取（whoop summary、day-brief、health flags）和深度分析（whoop activity trend、whoop experiment report）。
关键特性包括：
- 本地 Keychain 认证：WHOOP 客户端密钥和访问令牌存储于 macOS Keychain，配置文件仅保留非敏感元数据
- 只读优先设计：推荐
summary、day-brief、trend、sync pull等安全命令，避免不必要的写入操作 - 实验追踪协议：内置 A/B 测试框架，支持
experiment plan/context/status/report完整生命周期管理 - 多代理兼容：可安装为
~/.agents、~/.codex或 OpenClaw 技能
显著优点
1. 隐私优先架构：相比 OAuth 重定向或云端托管方案，本地 Keychain 存储大幅降低凭证泄露风险
2. 结构化实验支持：少有的消费级健康工具内置科学实验协议，适合严谨的自我量化（QS）实践
3. Agent 原生设计：输出格式为 JSON，过滤参数丰富（--labeled-only、--sport-id 等），便于自动化处理
4. 离线数据主权：sync pull 支持完整数据导出至本地 JSONL，避免云厂商锁定
潜在缺点与局限性
- 平台受限：依赖 macOS Keychain 和
/usr/bin/swift，Linux/Windows 用户无法使用 - 非官方维护：WHOOP API 变更可能导致工具失效，无 SLA 保障
- 安装门槛：需 Node.js 环境和 npm 全局安装，对非技术用户不够友好
- 功能边界：部分高级分析（如心率变异性频域分析）需自行处理原始数据
适合人群
- 使用 WHOOP 穿戴设备且熟悉命令行的技术用户
- 追求数据主权的自我量化（Quantified Self）研究者
- 需要自动化健康报告或实验追踪的运动员/教练
- 对云同步有顾虑、偏好本地存储的隐私敏感用户
常规风险
1. Keychain 访问故障：沙盒环境或 CI 容器可能无法访问 macOS Keychain，需回退到标准用户权限
2. Swift 运行时缺失：旧版 macOS 或未安装 Xcode Command Line Tools 的系统会出现认证失败
3. API 速率限制：频繁调用可能触发 WHOOP 限流，建议合理设置 --days 范围
4. 实验状态漂移：experiments.json 为唯一可信源，手动编辑其他文件可能导致数据不一致