whoop

What This Skill Does

The WHOOP skill provides OpenClaw agents with the ability to interface directly with the WHOOP wearable ecosystem. By leveraging the official WHOOP REST API, this skill allows users to extract highly granular biometric, sleep, and performance data without needing to manually open the WHOOP mobile app. It serves as a bridge for agents to analyze physiological trends, providing data-backed insights on recovery, readiness for strain, and long-term health improvements. Whether you are tracking daily cardiovascular load or monitoring sleep quality improvements, this skill streamlines data retrieval for health-conscious users.

Installation

To integrate the WHOOP skill, ensure you have Python 3.7+ installed. Begin by installing the skill using the command: clawdhub install openclaw/skills/skills/ijaack/whoop-tracker. Once installed, you must navigate to the developer portal at developer.whoop.com to register your application and acquire your unique client_id and client_secret. Store these securely in a ~/.whoop/credentials.json file with restricted permissions. Finally, follow the OAuth flow to authorize the agent to access your data. For full automation, ensure the requests library is installed in your local environment.

Use Cases

This skill is ideal for fitness enthusiasts and individuals monitoring their health metrics. Typical use cases include:

1. Readiness Assessment: Determining if a user is recovered enough for a heavy workout based on their Recovery Score.
2. Trend Analysis: Reviewing weekly sleep consistency or heart rate variability (HRV) patterns.
3. Post-Workout Review: Summarizing strain, heart rate zones, and caloric expenditure after a logged activity.
4. Health Monitoring: Tracking resting heart rate and blood oxygen levels over time to spot potential health issues or overtraining.

Example Prompts

1. "Check my recovery score for today; am I ready for a high-intensity workout?"
2. "How did my sleep quality look last night, and did I hit my recovery goal?"
3. "List my last three workouts and tell me which one resulted in the highest strain."

Tips & Limitations

The WHOOP API requires an active authorization token, so ensure you perform the OAuth handshake correctly during initial setup. Note that the skill is dependent on your device syncing data to the WHOOP cloud, so real-time data may be subject to a slight delay as the wearable uploads to the servers. When requesting long date ranges, consider the pagination limits of the API to avoid incomplete data retrieval. Keep your credentials file secure at all times.