← 返回 Skills 市场
190
总下载
1
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install whoop-connect - 安装完成后,直接呼叫该 Skill 的名称或使用
/whoop-connect触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 190 次。
如何安装 Whoop Connect?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install whoop-connect」即可一键安装,无需额外配置。
Whoop Connect 是免费的吗?
是的,Whoop Connect 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Whoop Connect 支持哪些平台?
Whoop Connect 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Whoop Connect?
由 Belugary(@belugary)开发并维护,当前版本 v0.5.0。
推荐 Skills