| 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)
- Create a WHOOP app and get credentials:
WHOOP_CLIENT_ID
WHOOP_CLIENT_SECRET
- In the WHOOP developer dashboard, set Redirect URL:
https://localhost:3000/callback
- Put secrets into
~/.clawdbot/.env:
WHOOP_CLIENT_ID=...
WHOOP_CLIENT_SECRET=...
- 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.