whoop-morning

What This Skill Does

The whoop-morning skill is a specialized automation tool designed to bridge the gap between your biometric data and your daily workflow. It interacts with the WHOOP API to pull your most recent recovery, sleep, and strain metrics immediately after you wake up. Once the data is retrieved, it generates a human-readable summary that offers actionable suggestions based on your body's physiological state. By integrating this into your morning routine, you gain a data-driven perspective on your health, allowing you to tailor your workout intensity, workload, or rest schedule to match your current recovery levels.

Installation

To install this skill, use the command: clawhub install openclaw/skills/skills/borahm/whoop-morning. Once installed, you must configure your OAuth credentials. First, add your WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET to the ~/.clawdbot/.env file. Next, run /home/claw/clawd/skills/whoop-morning/bin/whoop-auth --scopes offline read:recovery read:sleep read:cycles read:profile to trigger the authorization flow. Follow the terminal prompts by opening the provided URL, authorizing the app, and pasting the resulting code back into your terminal. This process saves a secure refresh token to your environment file. Finally, add the execution command /home/claw/clawd/skills/whoop-morning/bin/whoop-morning to your daily cron schedule via the Gateway to automate the report generation.

Use Cases

• High-performance athletes managing Overtraining Syndrome and daily exertion loads.
• Remote workers looking to optimize their daily schedule based on restorative sleep cycles.
• Quantified-self enthusiasts who aggregate health data for long-term pattern analysis.
• Individuals balancing high-stress careers with physical health goals, ensuring activity levels remain sustainable.

Example Prompts

• "Hey Claw, run the whoop-morning report and tell me if I should push hard during today's training session."
• "Send my WHOOP recovery summary to my daily task manager."
• "What does my current sleep and strain data suggest about my upcoming workload for today?"

Tips & Limitations

Note that WHOOP utilizes a rotational refresh token system. To avoid authorization errors, do not trigger multiple refresh requests simultaneously. If you encounter 401 or 400 errors, re-running the whoop-auth utility is the standard fix. Ensure your system clock is synchronized to prevent API handshake failures. Because this skill relies on an external API, intermittent service downtime from WHOOP may cause the skill to report missing data.