A comprehensive CLI tool for fetching and analyzing WHOOP health metrics including sleep, recovery, HRV, and strain.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whoopskill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install whoopskill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is whoopskill?
whoopskill is a professional command-line interface built to interface directly with the WHOOP API v2, providing developers and data enthusiasts with immediate access to their biometric data. By integrating this tool into your Openclaw Skills library, you can programmatically monitor recovery scores, heart rate variability, and sleep performance without relying on a mobile interface.
The tool is designed for high-performance health tracking, offering both human-readable formatted summaries and raw JSON output. This flexibility makes it an essential utility for those looking to build personal health dashboards, automate lifestyle adjustments based on recovery data, or perform deep-dive trend analysis on their physiological markers.
whoopskill Use Cases
- Tracking daily recovery and HRV trends directly from a developer terminal.
- Generating automated health reports and AI-style insights for performance optimization.
- Exporting raw health data (sleep stages, strain, workouts) into JSON for local storage or analysis.
- Monitoring 30-day health trends to identify long-term physiological shifts.
- Quick-glance health status checks using color-coded terminal indicators.
How whoopskill Works
- The user initiates the OAuth flow to authorize the tool via the WHOOP API v2.
- Access and refresh tokens are securely stored locally in the ~/.whoop-cli/ directory for persistent session management.
- Upon command execution, whoopskill queries the WHOOP backend for specific data modules like recovery, sleep, or workouts.
- The raw API response is parsed and can be enhanced with trend calculations or insight logic.
- The tool outputs the final data to stdout, supporting both interactive terminal use and pipeline automation.
whoopskill Setup
To get started with whoopskill, install the package via npm and configure your API credentials:
npm install -g whoopskill
Ensure your environment variables are set in your shell profile:
export WHOOP_CLIENT_ID='your_client_id'
export WHOOP_CLIENT_SECRET='your_client_secret'
export WHOOP_REDIRECT_URI='your_redirect_uri'
Finally, run the authentication command to link your account:
whoopskill auth login
whoopskill Data Schema & Taxonomy
whoopskill structures data across several key health domains, ensuring a clean taxonomy for your Openclaw Skills workflows:
| Domain | Description |
|---|---|
| Recovery | Contains recovery percentage, HRV (RMSSD), RHR, SpO2, and skin temperature. |
| Sleep | Details sleep cycles, stages (REM, Light, Deep), efficiency, and respiratory rate. |
| Workout | Captures specific activity strain, heart rate zones, and caloric burn. |
| Cycle | Provides the aggregate daily strain and total calories for a 24-hour period. |
| Profile | User-specific data including height, weight, and max heart rate. |
whoopskill Advanced Features
- Trend direction indicators (arrows) showing the trajectory of your recovery and HRV over 7 or 30 days.
- AI-style health recommendations that provide actionable advice based on current sleep debt and strain capacity.
- Support for specific date queries to retrieve historical performance data.
- Color-coded status indicators (Green/Yellow/Red) for rapid visual assessment of biometric health.
- Seamless JSON output mode to facilitate integration with other automation scripts and data pipelines.
SKILL.md
Loading
Related Openclaw Skills
Canvas OS
An application platform that turns the OpenClaw Canvas into a dynamic environment for running and controlling rich HTML/CSS/JS applications.
Antigravity Image Generation
Native high-quality image generation using the Google Antigravity API and Gemini 3 Pro without browser automation.
Agent Orchestrator
A meta-agent skill that decomposes macro tasks into subtasks and manages specialized autonomous sub-agents for complex workflow execution.
Agent Browser
A high-performance Rust-based headless browser automation CLI designed for AI agents to navigate and interact with the web using structured commands.
GuavaGuard
A real-time runtime security monitor that identifies and warns against malicious patterns during agent execution.
GuavaMemory
A structured episodic memory system that uses Q-value scoring to help AI agents remember successful patterns and avoid past mistakes.
METADATA
Featured*
