whoop-integration
Integrate with WHOOP fitness tracker API to monitor sleep, recovery, and strain data. Use when you need to check sleep quality, recovery scores, analyze fitness patterns, set up morning behavior adjustments based on sleep performance, or create automated health monitoring workflows. Supports OAuth authentication, sleep performance tracking, and adaptive assistant behavior.
Why use this skill?
Integrate your WHOOP fitness data into OpenClaw for automated recovery reports, sleep tracking, and personalized health analysis.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/valeraolexienko/whoop-integrationWhat This Skill Does
The whoop-integration skill provides a robust bridge between the OpenClaw AI agent and your WHOOP fitness tracker API. It allows the agent to ingest high-fidelity biometric data, specifically focusing on sleep quality, physiological recovery, and strain metrics. By abstracting the complexities of OAuth token management and V2 API interactions, this skill enables automated morning briefings, adaptive workout scheduling based on your readiness score, and long-term trend analysis. It acts as your personal health data analyst, converting raw milliseconds and complex JSON structures into actionable advice for your daily routine.
Installation
To install this skill, run the following command in your terminal:
clawhub install openclaw/skills/skills/valeraolexienko/whoop-integration
Ensure that you have set the WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET environment variables in your OpenClaw configuration. The skill will automatically handle token storage and rotation in ~/.openclaw/whoop_tokens.json.
Use Cases
- Automated Morning Briefings: Get a concise, translated summary of your recovery, HRV, and sleep stages delivered directly to Telegram every morning.
- Adaptive Training Intensity: Allow the AI to adjust your planned workout intensity based on your recovery score (e.g., suggesting a rest day if your recovery falls below 34%).
- Health Pattern Analysis: Query the agent to compare your HRV trends or sleep consistency over the last 30 days to identify correlations between lifestyle habits and physiological health.
- Proactive Health Notifications: Use the agent to trigger alerts if your resting heart rate deviates significantly from your established baseline.
Example Prompts
- "Check my recovery score for today and tell me if I should go for a high-intensity run or prioritize active recovery."
- "Summarize my sleep quality from last night. How much deep sleep did I get, and was it enough to reach my recovery goal?"
- "Analyze my strain and recovery trends over the past week and let me know if I am trending towards overtraining."
Tips & Limitations
- V2 API Requirement: Always ensure the integration points to the V2 endpoints. Attempting to use V1 will result in 404 errors.
- Token Management: The skill handles token rotation automatically when expiry is within 1 hour. Do not manually edit the
whoop_tokens.jsonfile unless troubleshooting. - Data Latency: Note that WHOOP data may take some time to sync from your device to their cloud API, so real-time updates immediately upon waking may vary.
- Safety: Always treat the AI's suggestions as guidelines, not as medical advice. Always prioritize how you physically feel over biometric scores.
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-valeraolexienko-whoop-integration": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, external-api, network-access