whoo-cli

What This Skill Does

The whoo-cli skill serves as a secure, authorized bridge between the OpenClaw AI agent and your personal WHOOP health ecosystem. It empowers the agent to fetch, process, and interpret complex biometrics directly from the WHOOP API. By leveraging the underlying whoo CLI utility, the agent can access granular recovery scores, heart rate variability (HRV), sleep performance analytics, strain levels, and physiological measurements. It is designed to act as your personal health data analyst, transforming raw wearable metrics into actionable insights about your readiness, fitness trends, and sleep quality without requiring you to manually navigate the WHOOP dashboard.

Installation

Installation requires a two-stage process. First, ensure you have the OpenClaw skill registered by running clawhub install openclaw/skills/skills/luisgot/whoo-cli. Second, you must have the underlying CLI installed on your machine using Bun or NPM: bun add -g @luisgot/whoo. After installation, execute whoo login to initialize the OAuth handshake. For secure environments or headless servers, use whoo login --manual to paste the callback URL directly into the terminal, ensuring your tokens are stored locally and encrypted within your operating system's config directory.

Use Cases

This skill is ideal for users who want to synthesize their health data into conversational summaries. You can use it to track 30-day recovery trends to optimize workout scheduling, analyze sleep debt accumulation, or check daily readiness scores before starting your morning routine. It is particularly useful for performance athletes who want to correlate historical sleep performance with daytime strain. By querying specific date ranges or limits, you can receive structured reports on your body's physiological adaptation to physical stress over time.

Example Prompts

1. "OpenClaw, check my recovery score for today and let me know if my HRV looks lower than my weekly average."
2. "Can you pull my sleep performance data from the last 7 days and summarize my sleep efficiency trends?"
3. "Analyze my strain levels for the last month—has my recovery been trending upward as I increase my activity?"

Tips & Limitations

The whoo-cli skill processes sensitive biometric data locally. For privacy, raw data is never transmitted to external logging services or third-party analytical platforms. When requesting data for programmatic analysis, use the --json flag to receive structured output that the AI can reliably parse. Always remember that the skill's accuracy is entirely dependent on the data synced to your WHOOP account; if you haven't synced your wearable recently, the data returned will be delayed. Avoid requesting data ranges exceeding 100 entries in a single call to maintain optimal performance.