← Back to Skills Marketplace
belugary

Whoop Connect

by Belugary · GitHub ↗ · v0.5.0 · MIT-0
cross-platform ✓ Security Clean
190
Downloads
1
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install whoop-connect
Description
Connect WHOOP wearable to OpenClaw — fetch and store recovery, sleep, HRV, strain, and workout data locally. Use when: user asks about recovery, sleep qualit...
Usage Guidance
This skill appears coherent with its stated purpose, but consider these before installing: - Secrets: WHOOP_CLIENT_SECRET is required. Avoid embedding it into world-readable files. The example systemd unit shows the secret in Environment lines — that can make the secret visible to other local users and in some system tools. Prefer a protected environment file (root-owned, 0600) or a secrets manager, and ensure unit files have restricted permissions. - Local storage: The skill stores tokens and data under ~/.whoop (whoop.db and config.json). Back up or delete these files if you later revoke access. The code includes safeguards (e.g., not to print secrets) but review logs and your systemd service configuration to avoid verbose secret logging. - Network exposure: Enabling webhooks requires hosting a public HTTPS endpoint and configuring WHOOP to call it — that increases your network exposure. Only enable webhooks if you understand and control the hosting domain/reverse proxy and TLS setup. - Auto-sync frequency and rate limits: Default polling is every 5 minutes (or 20 minutes when webhook healthy) with an estimated per-day API-call heuristic and a default daily_api_limit of 10,000. If you run frequent polling or multiple instances, you may hit WHOOP rate limits; adjust sync_interval/daily_api_limit accordingly. - Review code if concerned: The repository is self-contained and uses common libraries. If you want higher assurance, inspect whoop_client.py (token handling, refresh behavior), webhook_server.py (what it logs/returns), and install.sh. The install uses a local venv and pip; no remote arbitrary code downloads are used beyond PyPI packages. If you accept these operational considerations and secure the client secret appropriately, the skill's requests and behavior are proportionate to its functionality.
Capability Analysis
Type: OpenClaw Skill Name: whoop-connect Version: 0.5.0 The whoop-connect skill is a legitimate integration for fetching WHOOP wearable data via the official WHOOP API v2. It implements a standard OAuth2 flow with local token storage, SQLite persistence in `~/.whoop/whoop.db`, and an optional Flask-based webhook receiver (`webhook_server.py`) for real-time updates. The code is well-documented, follows the stated purpose of local data processing, and includes explicit safety instructions in `SKILL.md` to prevent the AI agent from leaking credentials or deleting data.
Capability Assessment
Purpose & Capability
Name/description, required binaries (python3), required env vars (WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET), and the listed commands map directly to the included Python scripts that call the WHOOP developer API and persist data to ~/.whoop/whoop.db. No unrelated credentials, binaries, or behavior are requested.
Instruction Scope
SKILL.md instructs only on creating a WHOOP developer app, setting the two OAuth env vars, running the included setup/install scripts, starting optional auto-sync/webhook services, and reading/writing files under ~/.whoop. The instructions do not request unrelated system data or external endpoints beyond WHOOP developer URLs and the optional webhook hosting domain that the user must provide.
Install Mechanism
Install is a local shell script that creates a Python venv and pip-installs well-known packages (requests, flask). No downloads from arbitrary hosts, no extracted archives, and no third-party registries beyond PyPI usage via pip. The installer creates a small wrapper script to invoke the venv python and a ~/.whoop directory with restricted permissions.
Credentials
The skill requires only WHOOP_CLIENT_ID and WHOOP_CLIENT_SECRET, which is appropriate for OAuth. However, operational examples (systemd unit in the setup guide) put the client secret in unit Environment lines; those files and process environment can expose secrets if not handled carefully. The skill warns not to print secrets, but users should consider secure storage and file permissions.
Persistence & Privilege
always is false, the skill does not request permanent platform-wide inclusion, and it doesn't modify other skills. It persists data only under ~/.whoop and creates a virtualenv under the skill directory; this is consistent with its purpose. Running optional daemons or webhooks requires normal user/system service privileges but is user-initiated.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install whoop-connect
  3. After installation, invoke the skill by name or use /whoop-connect
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.5.0
Add smart auto-sync daemon with adaptive polling (webhook: 20min fallback, no webhook: 5min primary), daily API rate limiting (10k/day), and configurable sync intervals
v0.4.0
Remove self-added analysis; keep skill focused on WHOOP data connection
v0.3.0
Reposition as WHOOP-to-OpenClaw bridge; explain developer account; add official doc links
v0.2.0
Improved description with Use when/NOT for triggers, bilingual README
v0.1.0
Initial release of whoop-connect — access and analyze WHOOP health data locally. - Fetch and analyze recovery, sleep, HRV, strain, and workout data from WHOOP. - On-demand metric queries and trend analysis with SQLite storage. - Includes user-customizable settings (language, detail level, units, trend comparison, training advice). - Optional webhook support for real-time data ingestion. - Setup and troubleshooting guides provided.
Metadata
Slug whoop-connect
Version 0.5.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is Whoop Connect?

Connect WHOOP wearable to OpenClaw — fetch and store recovery, sleep, HRV, strain, and workout data locally. Use when: user asks about recovery, sleep qualit... It is an AI Agent Skill for Claude Code / OpenClaw, with 190 downloads so far.

How do I install Whoop Connect?

Run "/install whoop-connect" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Whoop Connect free?

Yes, Whoop Connect is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Whoop Connect support?

Whoop Connect is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Whoop Connect?

It is built and maintained by Belugary (@belugary); the current version is v0.5.0.

💬 Comments