# Send Whoop to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "whoop-health-analysis",
    "name": "Whoop",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/rodrigouroz/whoop-health-analysis",
    "canonicalUrl": "https://clawhub.ai/rodrigouroz/whoop-health-analysis",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/whoop-health-analysis",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=whoop-health-analysis",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/api.md",
      "references/health_analysis.md",
      "scripts/whoop_auth.py",
      "scripts/whoop_chart.py",
      "scripts/whoop_data.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/whoop-health-analysis"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/whoop-health-analysis",
    "downloadUrl": "https://openagent3.xyz/downloads/whoop-health-analysis",
    "agentUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent",
    "manifestUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/whoop-health-analysis/agent.md"
  }
}
```
## Documentation

### Whoop

Query health metrics from the Whoop API and generate interactive HTML charts.

### 1. Create a Whoop Developer App

Go to developer-dashboard.whoop.com
Sign in with your Whoop account credentials
Create a Team if prompted (any name works)
Click Create App (or go to apps/create)
Fill in:

App name: anything (e.g., "Clawdbot")
Scopes: select ALL: read:recovery, read:cycles, read:workout, read:sleep, read:profile, read:body_measurement
Redirect URI: http://localhost:9876/callback


Click Create — you'll get a Client ID and Client Secret

### 2. Authenticate

Run the OAuth login flow with your credentials:

python3 scripts/whoop_auth.py login \\
  --client-id YOUR_CLIENT_ID \\
  --client-secret YOUR_CLIENT_SECRET

This opens a browser for Whoop authorization. Log in and approve access. Tokens are stored in ~/.clawdbot/whoop-tokens.json and auto-refresh.

Check status: python3 scripts/whoop_auth.py status

### Fetching Data

Use scripts/whoop_data.py to get JSON data:

# Sleep (last 7 days default)
python3 scripts/whoop_data.py sleep --days 14

# Recovery scores
python3 scripts/whoop_data.py recovery --days 30

# Strain/cycles
python3 scripts/whoop_data.py cycles --days 7

# Workouts
python3 scripts/whoop_data.py workouts --days 30

# Combined summary with averages
python3 scripts/whoop_data.py summary --days 7

# Custom date range
python3 scripts/whoop_data.py sleep --start 2026-01-01 --end 2026-01-15

# User profile / body measurements
python3 scripts/whoop_data.py profile
python3 scripts/whoop_data.py body

Output is JSON to stdout. Parse it to answer user questions.

### Generating Charts

Use scripts/whoop_chart.py for interactive HTML visualizations:

# Sleep analysis (performance + stages)
python3 scripts/whoop_chart.py sleep --days 30

# Recovery bars (color-coded green/yellow/red)
python3 scripts/whoop_chart.py recovery --days 30

# Strain & calories trend
python3 scripts/whoop_chart.py strain --days 90

# HRV & resting heart rate trend
python3 scripts/whoop_chart.py hrv --days 90

# Full dashboard (all 4 charts)
python3 scripts/whoop_chart.py dashboard --days 30

# Save to specific file
python3 scripts/whoop_chart.py dashboard --days 90 --output ~/Desktop/whoop.html

Charts open automatically in the default browser. They use Chart.js with dark theme, stat cards, and tooltips.

### Answering Questions

User asksAction"How did I sleep?"whoop_data.py summary --days 7, report sleep performance + hours"How's my recovery?"whoop_data.py recovery --days 7, report scores + trend"Show me a chart for the last month"whoop_chart.py dashboard --days 30"Is my HRV improving?"whoop_data.py recovery --days 30, analyze trend"How much did I train this week?"whoop_data.py workouts --days 7, list activities

### Key Metrics

Recovery (0-100%): Green ≥67%, Yellow 34-66%, Red <34%
Strain (0-21): Daily exertion score based on HR
Sleep Performance: Actual sleep vs. sleep needed
HRV (ms): Higher = better recovery, track trend over time
RHR (bpm): Lower = better cardiovascular fitness

### Health Analysis

When the user asks about their health, trends, or wants insights, use references/health_analysis.md for:

Science-backed interpretation of HRV, RHR, sleep stages, recovery, strain, SpO2
Normal ranges by age and fitness level
Pattern detection (day-of-week effects, sleep debt, overtraining signals)
Actionable recommendations based on data
Red flags that suggest medical consultation

### Analysis workflow

Fetch data: python3 scripts/whoop_data.py summary --days N
Read references/health_analysis.md for interpretation framework
Apply the 5-step analysis: Status → Trends → Patterns → Insights → Flags
Always include disclaimer that this is not medical advice

### References

references/api.md — endpoint details, response schemas, pagination
references/health_analysis.md — science-backed health data interpretation guide
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: rodrigouroz
- Version: 1.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/whoop-health-analysis)
- [Send to Agent page](https://openagent3.xyz/skills/whoop-health-analysis/agent)
- [JSON manifest](https://openagent3.xyz/skills/whoop-health-analysis/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/whoop-health-analysis/agent.md)
- [Download page](https://openagent3.xyz/downloads/whoop-health-analysis)