SkillHub

whoop

v0.1.0

WHOOP morning check-in (recovery/sleep/strain) with suggestions.

Sourced from ClawHub, Authored by Borahm

Installation

Please help me install the skill `whoop` from SkillHub official store. npx skills add Borahm/whoop

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.