Openclaw Whoop

# WHOOP (Official API)

Use this skill to **connect WHOOP → fetch metrics → produce a message**.

Scope: WHOOP is the data source only. Keep delivery channel-agnostic: generate text/markdown and either reply in the current chat or send via OpenClaw’s `message` tool.

## Quick start (minimal)

1) Set env vars:

- `WHOOP_CLIENT_ID`
- `WHOOP_CLIENT_SECRET`
- `WHOOP_REDIRECT_URI`

2) Connect once (choose one):

**Phone/remote mode (recommended):** run, then copy/paste the redirect URL or code back into chat.

```bash
python3 scripts/whoop_oauth_login.py
```

**Desktop fast path (optional):** if you are authorizing in a browser on the same machine that runs OpenClaw, set `WHOOP_REDIRECT_URI` to a loopback URL (e.g. `http://127.0.0.1:58539/callback`) and run:

```bash
python3 scripts/whoop_oauth_login.py --loopback
```

3) Fetch + render today:

```bash
python3 scripts/whoop_fetch.py --date today --out /tmp/whoop_raw_today.json
python3 scripts/whoop_normalize.py /tmp/whoop_raw_today.json --out /tmp/whoop_today.json
python3 scripts/whoop_render.py /tmp/whoop_today.json --format markdown --channel generic
```

## Configuration (required)

Provide these via environment variables (preferred) or direct CLI args to scripts:

- `WHOOP_CLIENT_ID`
- `WHOOP_CLIENT_SECRET`
- `WHOOP_REDIRECT_URI` (must exactly match the value in the WHOOP developer dashboard)

Optional:

- `WHOOP_TOKEN_PATH` (default: `~/.config/openclaw/whoop/token.json`)
- `WHOOP_TZ` (default: `Asia/Shanghai`)

## Workflow 1 — Connect WHOOP (OAuth login)

1) Run one of these modes:

- **Phone/remote mode (recommended):**

```bash
python3 scripts/whoop_oauth_login.py
```

Then open the printed URL on any device, approve access, and paste the redirect URL (or code) back into the prompt.

- **Desktop loopback mode (optional):**

```bash
python3 scripts/whoop_oauth_login.py --loopback
```

Use this only if your browser authorization happens on the same machine that runs OpenClaw, and `WHOOP_REDIRECT_URI` is a loopback...