whoop-lab
Fetch, analyze, chart, and track WHOOP health data (recovery, HRV, RHR, sleep, strain, workouts). Use when: querying any WHOOP metric; generating visual charts or dashboards; planning, monitoring, or reporting on a health experiment (with auto-captured baselines, post-workout segmentation); logging stats to Obsidian; correlating health data with life context; or proactively flagging suppressed recovery trends. Handles OAuth, token refresh, full history pagination, and science-backed metric interpretation (HRV ranges by age, overtraining signals, sleep stage targets, medication context).
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/brennaman/whoop-labWhat This Skill Does
The whoop-lab skill is an advanced integration for the WHOOP health tracker, designed to bridge the gap between raw biometrics and actionable insights. It interfaces directly with the WHOOP Developer API (v2) to fetch, interpret, and visualize health data including heart rate variability (HRV), resting heart rate (RHR), recovery scores, sleep architecture, and strain metrics. The skill is engineered for power users who want more than just the mobile app’s summary view, enabling granular data analysis, correlation with external life events, and longitudinal tracking.
Installation
- Ensure you have the OpenClaw environment active and run
clawhub install openclaw/skills/skills/brennaman/whoop-lab. - Install Python dependencies:
pip install -r requirements.txt. - Create your WHOOP Developer App at https://developer-dashboard.whoop.com, selecting all
read:*scopes and theofflinescope. - Execute
python3 scripts/auth.pyto initiate the OAuth handshake. Choose between the local server callback or the manual code paste method depending on your hosting environment. - Optionally, customize your configuration by copying
config.example.jsonto~/.config/whoop-skill/config.jsonto set your vault paths or timezone settings.
Use Cases
- Longitudinal Trend Analysis: Track how specific supplements or lifestyle changes affect your HRV over a 30-day period.
- Recovery Contextualization: Automatically pull your recovery data into your daily Obsidian notes to correlate sleep quality with work-day strain.
- Overtraining Alerts: Receive notifications or dashboard visualiztions when your strain-to-recovery ratio suggests an increased risk of illness or injury.
- Health Experiment Tracking: Baseline your physiological markers before starting a new exercise regimen and track deviations over time.
Example Prompts
- "Analyze my HRV trends from the last two weeks and correlate them with the recovery scores to see if my evening workouts are impacting my sleep quality."
- "Generate a summary of my recovery and strain for the current week and append it to my Obsidian daily note for today."
- "Compare my current RHR against my 30-day moving average and flag if I am trending above my normal baseline."
Tips & Limitations
- Data Privacy: All your credentials are stored locally in
~/.config/whoop-skill/. Ensure this directory has appropriate file permissions. - Pagination: The skill handles full history pagination, but fetching multi-year datasets may take time depending on API response rates.
- Science-backed context: Use the skill to access age-adjusted normative ranges for HRV to better understand your personal biometrics.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-brennaman-whoop-lab": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api