whoopskill

What This Skill Does

The whoopskill is a comprehensive interface for the WHOOP health platform, enabling OpenClaw agents to fetch, analyze, and interpret physiological data directly from the command line or an AI workflow. By integrating with the WHOOP API v2, it bridges the gap between raw biometric telemetry and actionable health intelligence. The skill provides granular insights into sleep performance, recovery metrics, heart rate variability (HRV), and strain, allowing users to track their physical well-being with precision. Beyond simple data retrieval, whoopskill includes intelligent analysis features like trend identification and AI-powered health recommendations, helping users optimize their training and recovery cycles.

Installation

You can install this skill globally via npm to use it as a standalone utility, or integrate it into your OpenClaw environment using the package manager. For standalone usage, run: npm install -g whoopskill. To install directly into your OpenClaw skill registry, execute the following command in your terminal: clawhub install openclaw/skills/skills/koala73/whoopskill. Ensure you have authenticated via whoopskill auth login to authorize the OAuth flow before attempting to fetch your personal metrics.

Use Cases

• Athletic Performance Management: Monitor recovery scores and HRV to determine if today is optimal for high-intensity training or active rest.
• Sleep Optimization: Analyze sleep stages and efficiency metrics to identify patterns that impact daytime energy levels.
• Trend Analysis: Use the --trends flag to view 7-day or 30-day averages, providing a long-term view of your physiological baseline.
• Contextual Health Reporting: Combine multiple data types, such as --sleep, --recovery, and --body, to generate a holistic daily health report tailored to your recent strain.
• Automated AI Coaching: Use the insights command to receive personalized health recommendations based on current physiological data, acting as a virtual performance coach.

Example Prompts

1. "Check my WHOOP stats for today; how is my recovery looking and do I have capacity for a heavy workout?"
2. "Show me the 30-day trend for my sleep and HRV to see if my recovery is trending upward."
3. "Summarize my latest sleep and recovery data and give me some AI insights on how to improve my performance."

Tips & Limitations

• Date Boundaries: Remember that WHOOP operates on a 4am daily cutoff. Requests for specific dates follow this convention.
• Output Format: By default, output is structured as JSON, making it ideal for piping into other scripts. Use the --pretty flag for human-readable output.
• Security: Tokens are stored locally in ~/.whoop-cli/tokens.json. Keep this directory secure.
• Data Freshness: The skill automatically refreshes expired tokens, ensuring a seamless experience, but note that data sync latency depends on the WHOOP cloud infrastructure.