A comprehensive health integration that fetches, interprets, and charts WHOOP biometric data to optimize recovery and track fitness experiments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whoop-lab
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install whoop-lab using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is WHOOP Lab?
WHOOP Lab is a technical powerhouse within the Openclaw Skills ecosystem designed to turn raw biometric data into actionable insights. By leveraging the WHOOP Developer API (v2), this skill allows users to programmatically access their recovery scores, Heart Rate Variability (HRV), sleep stages, and strain metrics. It is built for developers and health-conscious users who want to move beyond the standard mobile app to perform deep-dive analysis and visualization.
The skill provides a robust framework for understanding the physiological signals of your body. Whether you are monitoring overtraining signals or correlating sleep quality with daily habits, WHOOP Lab provides the tools to bridge the gap between wearable data and personal knowledge management. It integrates seamlessly with Openclaw Skills to provide automated morning briefs and proactive health flagging based on science-backed metric interpretation.
WHOOP Lab Use Cases
- Monitoring daily recovery and HRV to determine optimal workout intensity.
- Visualizing 30-day health trends through interactive, self-contained HTML dashboards.
- Running controlled health experiments with automated baseline capturing and post-workout segmentation.
- Automating the logging of health biometrics into Obsidian daily notes for long-term context.
- Receiving proactive alerts during morning check-ins when recovery scores fall into the red zone.
How WHOOP Lab Works
- Establishes a secure connection via OAuth 2.0 with the WHOOP Developer API, handling initial authorization and local token storage.
- Automatically manages token lifecycles by checking expiration times and executing refresh scripts before data requests.
- Pulls granular biometric data across multiple endpoints including recovery, sleep, and workout collections.
- Processes raw API responses to calculate trends, averages, and deviations from the user's personal baseline.
- Generates visual outputs using Chart.js or appends formatted Markdown tables to external personal knowledge bases.
WHOOP Lab Setup
To integrate this into your Openclaw Skills library, follow these steps:
- Install the required Python dependencies:
pip install -r requirements.txt
- Create a WHOOP Developer App at https://developer-dashboard.whoop.com and set the Redirect URI to
http://localhost:8888/callback. - Run the authentication script to link your account:
python3 scripts/auth.py
- (Optional) Configure your Obsidian vault path in
~/.config/whoop-skill/config.jsonto enable automated logging.
WHOOP Lab Data Schema & Taxonomy
WHOOP Lab organizes its data within the ~/.config/whoop-skill/ directory to ensure user privacy and portability. The data is structured as follows:
| File | Format | Description |
|---|---|---|
credentials.json |
JSON | Stores OAuth tokens and expiration metadata. |
experiments.json |
JSON | Tracks active and completed health experiments, hypotheses, and results. |
config.json |
JSON | Contains user preferences for timezones, Obsidian paths, and logging defaults. |
whoop-dashboard.html |
HTML | Self-contained visualization file generated for browser-based analysis. |
WHOOP Lab Advanced Features
- Post-workout segmentation that isolates recovery data specifically following high-strain sessions for more accurate experiment evaluation.
- Automated HTML dashboard generation featuring dark-theme stat cards and trend arrows for visual reporting.
- Heartbeat integration for Openclaw Skills that enables proactive health monitoring and morning status reports.
- Idempotent Obsidian logging that avoids duplicate entries while maintaining a consistent health history in your vault.
- Science-backed interpretation engine that provides context for HRV ranges, RHR trends, and sleep stage targets based on age and fitness level.
SKILL.md
Loading
Related Openclaw Skills
SnapTrade Portfolio
A comprehensive tool for connecting brokerage accounts through SnapTrade to monitor balances and execute stock trades automatically.
Session Memory
Bridges the gap between transient chat logs and long-term memory by summarizing sessions and enabling keyword-based history search.
Find Skills
A discovery and installation engine for extending AI agent capabilities through the open skills ecosystem.
Desktop Control Skill
A comprehensive automation suite providing pixel-perfect control over mouse, keyboard, and screen operations for AI agents.
Clabcraw AI Gaming Agent
An automated gaming skill that allows AI agents to compete in 1v1 high-stakes matches for USDC rewards.
Self-Reflection AI Agent Skill
A recursive optimization skill that enables AI agents to analyze their own performance and update their knowledge base automatically.
Featured*
