Whoop Cli

What This Skill Does

The Whoop Cli skill acts as a robust bridge between the OpenClaw agent and the WHOOP API, enabling automated access to personal biometrics, recovery data, and activity trends. By wrapping the @andreasnlarsen/whoop-cli utility, this skill allows the agent to execute complex queries and export reports without requiring the user to navigate the complexities of raw API plumbing. It serves as a personal health data assistant, capable of summarizing daily recovery, tracking sleep and strain patterns, and extracting granular activity logs directly into the agent's workflow.

Installation

To integrate this skill, first ensure Node.js is installed on your local environment. You can install the underlying command-line interface globally by running npm install -g @andreasnlarsen/[email protected]. Once installed, you can register the skill with OpenClaw by executing clawhub install openclaw/skills/skills/andreasnlarsen/whoop-cli. After installation, ensure you have your WHOOP developer credentials (Client ID, Client Secret, and Redirect URI) configured in your environment variables. The agent will use these to facilitate secure, token-based authentication stored locally on your machine, ensuring your credentials remain private.

Use Cases

• Daily Health Briefing: Retrieve your morning recovery score, sleep performance, and HRV data to inform your daily scheduling and workout intensity.
• Training Analysis: Analyze long-term strain trends by filtering activities to distinguish between intentional workouts and incidental movements.
• Data Archiving: Use the sync capability to export historical health metrics into JSONL files for custom data visualization or integration with other personal data stores.
• Recovery Optimization: Query your recent health flags to identify patterns between lifestyle choices and physiological recovery.

Example Prompts

1. "Check my WHOOP day brief for today and let me know if my recovery score suggests I should take a rest day or push hard in the gym."
2. "Show me a summary of my training activities over the last 30 days, but make sure to exclude non-labeled incidental movement."
3. "Pull my WHOOP data for the last month and save it to a JSONL file so I can review my health trends over the weekend."

Tips & Limitations

• Credential Security: Never share your Client Secret in chat. Perform the initial whoop auth login manually in your local terminal to establish the session.
• Interpretation Guardrail: The skill auto-detects generic activities (sport_id -1). Always request --labeled-only data when you are specifically interested in intentional training sessions to ensure high-fidelity insights.
• Local Execution: This skill relies on the local availability of the WHOOP binary. Ensure the path is correctly mapped in your environment if the agent reports it cannot locate the whoop command.