--- name: whoop description: WHOOP morning check-in (recovery/sleep/strain) with suggestions. metadata: clawdbot: config: requiredEnv: - WHOOP_CLIENT_ID - WHOOP_CLIENT_SECRET - WHOOP_REFRESH_TOKEN ---

whoop

WHOOP morning check-in:

• fetches your latest WHOOP data (Recovery, Sleep, Cycle/Strain)
• generates a short set of suggestions for the day

Quick Start (User + Bot)

What the user does (one-time)

1) Create a WHOOP app and get credentials:

• WHOOP_CLIENT_ID
• WHOOP_CLIENT_SECRET

2) In the WHOOP developer dashboard, set Redirect URL:

• https://localhost:3000/callback

3) Put secrets into ~/.clawdbot/.env:

WHOOP_CLIENT_ID=...
WHOOP_CLIENT_SECRET=...

4) Authorize once (get refresh token):

node /home/claw/clawd/skills/whoop/bin/whoop-auth --redirect-uri https://localhost:3000/callback

• Open the printed URL on your phone/browser
• Tap Allow/Authorize
• Copy the code from the callback URL and paste it back

This writes WHOOP_REFRESH_TOKEN=... into ~/.clawdbot/.env.

What the bot does (each run)

Run:

node /home/claw/clawd/skills/whoop/bin/whoop-morning

Then send the output back to the user.

Automation (daily)

Recommended: schedule with Gateway cron (daily morning).

• Command: node /home/claw/clawd/skills/whoop/bin/whoop-morning
• Bot should send the output as a message.

Notes

• OAuth endpoints:

- auth: https://api.prod.whoop.com/oauth/oauth2/auth - token: https://api.prod.whoop.com/oauth/oauth2/token

• Requires offline scope to receive refresh tokens.
• WHOOP rotates refresh tokens; the newest refresh token must be saved.