A specialized CLI tool for fetching and interpreting personal health metrics from the WHOOP API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install whoo-cli
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 whoo-cli 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 Whoo CLI?
The Whoo CLI skill enables users and automated agents to retrieve comprehensive health data directly from the WHOOP platform. It provides structured access to recovery scores, heart rate variability (HRV), sleep quality, physiological strain, SpO2, and body measurements. This tool is a vital component for those building personalized health dashboards or automated fitness tracking systems within the Openclaw Skills framework.
By leveraging OAuth for secure authentication, the skill allows for local processing of sensitive physiological data. It can return information in both human-readable text and programmatically accessible JSON, making it adaptable for both direct user interaction and complex multi-agent workflows.
Whoo CLI Use Cases
- Monitoring daily recovery scores to optimize physical training and readiness.
- Tracking 7-day or 30-day trends in sleep performance and respiratory rate.
- Automating the collection of body measurements and profile stats for health logging.
- Analyzing physiological strain across specific date ranges to prevent overtraining.
- Integrating real-time wearable data into larger personal data analytics pipelines.
How Whoo CLI Works
- The user installs the CLI utility and authenticates via the official WHOOP developer portal using OAuth.
- Commands are issued to the CLI to request specific health data types such as recoveries, cycles, or sleep sessions.
- The skill interfaces with the WHOOP API to fetch the most recent or historical data points.
- Data is parsed and validated, checking for states like PENDING_MANUAL to ensure accuracy.
- The results are output as structured data, allowing Openclaw Skills to interpret and present the health insights to the user.
Whoo CLI Setup
To get started, install the package using Bun or NPM:
bun add -g @luisgot/whoo
# or
npm install -g @luisgot/whoo
After installation, create a developer app at the WHOOP developer portal and set your redirect URI to http://127.0.0.1:8123/callback. Authenticate your account by running:
whoo login
For remote or headless environments, use the manual login flow:
whoo login --manual
Whoo CLI Data Schema & Taxonomy
The skill produces structured data that captures the core metrics of the WHOOP ecosystem. When using the --json flag, the data is organized as follows:
| Command | Key Metrics Returned |
|---|---|
whoo recovery |
recovery_score, resting_heart_rate, hrv_rmssd, spo2_percentage |
whoo sleep |
sleep_performance_percentage, respiratory_rate, sleep_consistency_percentage |
whoo overview |
Combined strain, recovery_score, and sleep data for a specific cycle |
whoo user |
height_metres, weight_kilograms, max_heart_rate |
Whoo CLI Advanced Features
- Support for the
--limitflag allows for batch retrieval of up to 100 historical records for trend analysis. - The
--jsonoutput mode ensures compatibility with data processing tools across the Openclaw Skills ecosystem. - Automated token persistence and refresh logic handle long-term authentication without manual intervention.
- Detailed error handling for unscorable data states ensures that agents do not misinterpret missing metrics.
- Headless environment compatibility via manual callback URL entry for SSH-based workflows.
SKILL.md
Loading
Related Openclaw Skills
Plane.so CLI
A zero-dependency Python CLI for managing Plane.so projects, issues, and team workflows directly from your terminal.
Zillow Scraper
A high-performance real estate data extraction tool for scraping Zillow listings, price history, and market analytics while bypassing Cloudflare protection.
YouTube Competitor Analysis
A powerful tool for analyzing YouTube competitor channels, trending content, and search keywords to reverse-engineer successful video strategies.
Web Scraping with Proxy Rotation
A professional methodology for reliable web scraping using residential proxy rotation, anti-detection headers, and browser automation.
Coding Agent Loops
Automate long-running AI coding tasks using persistent tmux sessions and self-healing retry loops.
Coding Sessions
Orchestrate persistent AI coding agents in tmux sessions with automatic notifications and health monitoring.
Featured*
