A powerful integration for retrieving and analyzing personalized WHOOP fitness data, including recovery, sleep, and strain metrics via optimized Python scripts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whoop-tracker
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-tracker 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 API Fitness Tracker?
The WHOOP API skill allows developers and fitness enthusiasts to programmatically access their biometric data from the WHOOP wearable ecosystem. By leveraging this integration within Openclaw Skills, you can automate the retrieval of high-fidelity health metrics such as heart rate variability (HRV), sleep performance, and daily strain scores. This skill acts as a bridge between the official WHOOP REST API and your local environment or AI agents, providing a structured way to monitor health trends and optimize physical performance.
Designed for technical users, this skill streamlines the complex OAuth 2.0 authentication process and provides a set of ready-to-use scripts for querying recovery readiness and workout intensity. Whether you are building a personal health dashboard or integrating biometric data into a larger automation workflow, this addition to your Openclaw Skills library ensures you have reliable, programmatic access to your WHOOP data.
WHOOP API Fitness Tracker Use Cases
- Monitoring daily recovery scores to adjust training intensity and prevent overtraining.
- Tracking sleep quality and efficiency over time to identify wellness patterns and lifestyle impacts.
- Exporting workout data and heart rate zones for personalized fitness coaching or performance analysis.
- Building automated health reporting tools using Openclaw Skills to visualize the correlation between strain and recovery.
How WHOOP API Fitness Tracker Works
- The skill initializes a secure connection to the WHOOP REST API using client credentials stored in a local configuration file.
- Users authenticate via a standard OAuth 2.0 flow, granting specific permissions for profile, recovery, sleep, and workout data.
- A core Python-based client manages the lifecycle of access tokens, including proactive refreshing before expiration and handling API rate limits.
- Execution scripts query specific endpoints (e.g., /v1/recovery or /v1/workout) using parameters like date ranges or record counts.
- The retrieved data is parsed and presented as structured JSON or human-readable console output, making it easy to use with other Openclaw Skills.
WHOOP API Fitness Tracker Setup
Prerequisites
- Python 3.7+
- The
requestslibrary (install viapip3 install requests).
Installation & Configuration
- Register your application at the WHOOP Developer Portal to obtain your
client_idandclient_secret. - Set up your local credentials directory:
mkdir -p ~/.whoop
cat > ~/.whoop/credentials.json <<EOF
{
\"client_id\": \"YOUR_CLIENT_ID\",
\"client_secret\": \"YOUR_CLIENT_SECRET\"
}
EOF
chmod 600 ~/.whoop/credentials.json
- Install the skill using your package manager:
clawdhub install whoop-tracker
- Follow the OAuth authorization flow described in the references to link your account.
WHOOP API Fitness Tracker Data Schema & Taxonomy
The skill organizes WHOOP data into several core categories, each mapped to specific physiological metrics:
| Category | Key Metrics |
|---|---|
| Recovery | Recovery Score (0-100), HRV (RMSSD), Resting Heart Rate, SPO2, Skin Temp |
| Sleep | Performance %, Duration (REM, SWS, Light), Efficiency %, Respiratory Rate |
| Cycle | Daily Strain Score (0-21), Energy Expenditure (KJ), Avg/Max Heart Rate |
| Workout | Activity-specific Strain, Sport Type, Heart Rate Zones (1-6), Distance/Altitude |
All collection endpoints support pagination via nextToken and filtering through ISO 8601 start and end timestamps, ensuring compatibility with the broader Openclaw Skills ecosystem.
WHOOP API Fitness Tracker Advanced Features
- Proactive OAuth token management with automatic background refreshing and expiry tracking.
- Robust error handling for API rate limits (HTTP 429) with automatic retry-after logic.
- Built-in pagination iterators for seamless retrieval of historical datasets over long timeframes.
- Granular command-line interface (CLI) support for filtering workouts by sport type or specific date ranges.
- Clean JSON output mode for piping data into other Openclaw Skills for advanced analysis or visualization.
SKILL.md
Loading
Related Openclaw Skills
ERC-8004 Identity Skill
A comprehensive framework for establishing on-chain AI agent identity, reputation, and task monetization on the Avalanche network.
Arena Agent
An autonomous AI agent designed for 24/7 engagement, monitoring, and contextual posting on the Arena.social platform.
Dooray! Webhook Notification Skill
A lightweight skill for sending automated messages and status updates to Dooray! messenger channels using secure webhooks.
opencode-omo
Turn coding requests into completed work by orchestrating specialized AI agents within the OpenCode runtime.
safe-edit
A safety-first utility that creates automatic rollbacks and backups before modifying critical configuration files.
Fabrik-Codek
A private cognitive architecture that builds a local knowledge graph from your workflows to personalize LLM interactions.
Featured*
