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.