← 返回 Skills 市场
272
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install whoop-lab
功能描述
Fetch, analyze, chart, and track WHOOP health data (recovery, HRV, RHR, sleep, strain, workouts). Use when: querying any WHOOP metric; generating visual char...
安全使用建议
This skill appears to be internally consistent with its WHOOP-focused purpose, but review these practical points before installing: 1) You must create a WHOOP Developer App and enter its client_id/client_secret interactively; those tokens (access + refresh) are stored at ~/.config/whoop-skill/credentials.json (file is set to 600 permissions by the script). 2) The auth flow can open a local HTTP server (localhost:8888) to capture the OAuth callback — if you run this on a remote/cloud host, prefer the manual code-paste option so nothing listens on a public port. 3) log_to_obsidian.py will write to and may commit/push your Obsidian vault if it's a git repo; verify vault_path in config and confirm you want those files committed/pushed to your remote. 4) The only network endpoints contacted are api.prod.whoop.com and the Chart.js CDN; if you require a stricter network policy, audit the scripts and run in a network-restricted environment first. 5) Source is listed as unknown — if you do not trust the bundle, inspect the scripts (they are plaintext Python) or run them in an isolated environment. 6) Test with dry-run modes (log_to_obsidian.py --dry-run) and review created files before enabling automated or agent-driven runs. If you want additional assurance, ask for a short checklist of the key files/lines to inspect and I can point to the exact places to verify (e.g., where tokens are saved, where git commands are invoked).
功能分析
Type: OpenClaw Skill
Name: whoop-lab
Version: 1.0.0
The WHOOP Lab skill is a well-structured tool for fetching and analyzing health data via the official WHOOP Developer API. It includes scripts for OAuth authentication (auth.py), data visualization (chart.py), and optional integration with Obsidian daily notes (log_to_obsidian.py). While the Obsidian script performs broad Git operations (git add -A && git push), these are explicitly documented as part of a vault synchronization feature and include safety checks to ensure the target directory is a valid Git repository. The code follows security best practices, such as setting restrictive file permissions (0o600) on credential files and using safe subprocess calls to prevent shell injection.
能力评估
Purpose & Capability
Name/description match the included scripts: auth (OAuth), fetch (WHOOP API), refresh_token, charting, experiment tracking, and Obsidian logging. Required binaries (python3, git) are justified (python3 to run scripts, git used only for optional vault sync). No unrelated credentials or external services are requested.
Instruction Scope
SKILL.md and the scripts operate within the described scope: they instruct creating a WHOOP Developer App, running auth.py to obtain OAuth tokens, fetching WHOOP endpoints, generating Chart.js HTML (via CDN), and optionally writing to an Obsidian vault. Important behaviors to note: the auth flow can spin up a local HTTP server to capture the OAuth callback (or use manual paste), credentials are saved to ~/.config/whoop-skill/credentials.json, and log_to_obsidian.py will create/append markdown files in your vault and can run git pull/add/commit/push. All of these are consistent with the skill's purpose but are file- and network-affecting actions you should expect.
Install Mechanism
No opaque or remote install spec; SKILL.md asks the user to pip install -r requirements.txt (requests only). No downloads from untrusted URLs or archive extraction are present in the files provided.
Credentials
The skill does not require environment variables or other unrelated credentials. It optionally respects WHOOP_EXPERIMENTS_FILE (to override experiments.json). OAuth client ID/secret are collected interactively and stored locally — appropriate for this integration. The only external endpoints contacted are the WHOOP API and Chart.js CDN (cdn.jsdelivr.net).
Persistence & Privilege
The skill writes persistent data to ~/.config/whoop-skill/ (credentials.json, experiments.json, config.json) and writes/updates files inside your configured Obsidian vault; it will attempt git pull/commit/push if the vault is a git repo. always:false and no global config modification — privileges are limited to the skill's own config directory and the user-specified vault, which is coherent but important to be aware of.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install whoop-lab - 安装完成后，直接呼叫该 Skill 的名称或使用
/whoop-lab触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
🚀 Initial Release - WHOOP Lab 1.0.0
First public release of the WHOOP Lab skill for OpenClaw / ClawHub.
Features:
📊 Data Fetching
OAuth 2.0 authentication with WHOOP Developer API v2 (scripts/auth.py)
Automatic token refresh (scripts/refresh_token.py)
General-purpose API fetcher for all WHOOP endpoints (scripts/fetch.py)
Recovery, sleep, strain, workouts, user profile
Date-range and limit-based pagination
📈 Charting
HTML chart generation via Chart.js (scripts/chart.py) — dark theme, fully self-contained
Recovery (color-coded green/yellow/red)
Sleep (stacked bar: REM/Deep/Light/Awake)
HRV trend (line + 7-day rolling average)
Strain + calories (dual axis)
Full dashboard (2×2 grid of all four)
Stat cards showing avg/min/max + trend arrows
Auto-opens in browser + delivers as attachment
🧪 Experiment Tracking
Plan, monitor, and evaluate personal health experiments (scripts/experiment.py)
Auto-captured 14-day baselines
Post-workout segmentation mode (measures recovery windows after qualifying workouts)
Mid-experiment status with rolling averages and trend arrows
Final report with verdict (met / partially met / not met / inconclusive)
Supports: HRV, recovery, sleep performance, RHR, strain
📓 Obsidian Logging (optional)
Appends daily WHOOP stats to Obsidian daily note (scripts/log_to_obsidian.py)
Backfill by date, dry-run preview
Auto git commit + push (skips git gracefully if vault is not a repo)
🧠 Health Interpretation
Science-backed HRV, RHR, sleep, strain, and recovery interpretation guide (references/health_analysis.md)
WHOOP API endpoint reference (references/api.md)
🌅 Morning Brief Integration
Drop-in HEARTBEAT.md snippet to include recovery + HRV in daily morning briefs
Red recovery auto-flagging (score < 34)
Requirements:
Python 3
Git (optional — only needed if Obsidian vault is a git repo)
A free WHOOP Developer App (https://developer-dashboard.whoop.com)
Setup:
See SKILL.md for full setup instructions.
元数据
常见问题
WHOOP Lab 是什么？
Fetch, analyze, chart, and track WHOOP health data (recovery, HRV, RHR, sleep, strain, workouts). Use when: querying any WHOOP metric; generating visual char... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 272 次。
如何安装 WHOOP Lab？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install whoop-lab」即可一键安装，无需额外配置。
WHOOP Lab 是免费的吗？
是的，WHOOP Lab 完全免费（开源免费），可自由下载、安装和使用。
WHOOP Lab 支持哪些平台？
WHOOP Lab 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 WHOOP Lab？
由 brennaman（@brennaman）开发并维护，当前版本 v1.0.0。
推荐 Skills