whoop-connect
Connect WHOOP wearable to OpenClaw — fetch and store recovery, sleep, HRV, strain, and workout data locally. Use when: user asks about recovery, sleep quality, HRV, heart rate, strain, workout stats, or any WHOOP data. NOT for: Apple Health, Oura, Garmin, or other non-WHOOP devices.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/belugary/whoop-connectWhat This Skill Does
The whoop-connect skill enables OpenClaw to interface directly with your WHOOP wearable data. By leveraging WHOOP’s developer platform, this skill fetches granular biometrics including recovery scores, sleep architecture, heart rate variability (HRV), strain, and comprehensive workout summaries. Unlike proprietary cloud-locked integrations, this skill emphasizes privacy: it pulls your data via secure OAuth and stores it locally in an encrypted database at ~/.whoop/whoop.db. This allows your agent to perform local data analysis, track long-term health trends, and provide contextual advice based on your physiological state without your sensitive health data ever leaving your local environment.
Installation
To install, run the command: clawhub install openclaw/skills/skills/belugary/whoop-connect. Once installed, ensure you have registered a personal app at the WHOOP developer portal to obtain your WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET. Add these to your environment variables. Upon the first request, the skill will guide you through the OAuth authentication flow. If you encounter any dependency issues, execute bash {baseDir}/scripts/install.sh. To finalize configuration, use python3 {baseDir}/scripts/setup.py --init followed by setting your preferred language.
Use Cases
This skill is perfect for users who want to treat their wearable data as a primary data source for personal optimization. Use it to check your readiness score before planning a workout, analyze how specific activities affect your recovery, compare sleep quality across different weeks, or keep an eye on your respiratory rate and HRV trends. It serves as an automated health assistant that turns raw sensor data into actionable insights.
Example Prompts
- "Based on my recovery score and HRV from the last three days, should I push hard in the gym today or stick to a recovery day?"
- "Show me a summary of my sleep efficiency and total duration for this past week."
- "What was my average strain during my workouts over the last month?"
Tips & Limitations
Note that WHOOP does not provide a public API for general consumer use, which is why manual developer app registration is required. Always use the --days N flag to scope your queries; for complex analysis, append --json to receive structured output for your LLM agent. If the sync appears stale, trigger a manual refresh with python3 {baseDir}/scripts/daily_sync.py --days 2 or start the background daemon with python3 {baseDir}/scripts/auto_sync.py. Keep in mind this skill is strictly for WHOOP; it will not interface with Apple Health or Garmin devices.
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-belugary-whoop-connect": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, external-api, code-execution