← Back to Skills Marketplace
kesslerio

Oura Ring Analytics

by kesslerio · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
2936
Downloads
7
Stars
3
Active Installs
4
Versions
Install in OpenClaw
/install oura-analytics
Description
Oura Ring data integration and analytics. Fetch sleep scores, readiness, activity, HRV, and trends from the Oura Cloud API. Generate automated reports, correlations with productivity, and trigger-based alerts for low recovery days. Requires OURA_API_TOKEN (get at cloud.ouraring.com).
Usage Guidance
This package appears to be a legitimate Oura data client and analytics tool. Before installing, verify the upstream repository (SKILL.md points to a GitHub repo) and inspect the code yourself if you can. When creating the Oura personal access token, grant the minimum read scopes necessary rather than 'all scopes.' Protect your tokens (do not commit them to git); the skill stores data locally under ~/.oura-analytics — clear or encrypt this if you are concerned about sensitive health data. If you use Telegram alerts, know that a Telegram bot token and chat ID are required and will be used to send messages. Finally, if you do not want the agent to run this skill autonomously, configure the agent/skill permissions accordingly.
Capability Analysis
Type: OpenClaw Skill Name: oura-analytics Version: 1.0.0 The OpenClaw AgentSkills bundle for Oura Analytics appears benign. It integrates with the Oura Cloud API and Telegram for legitimate purposes (fetching health data, sending alerts/reports). The OURA_API_TOKEN is handled securely via environment variables, and all data is stored locally in `~/.oura-analytics/cache/`. The `SKILL.md` instructions and `openclaw cron add` messages are descriptive and align with the stated purpose, showing no evidence of prompt injection to manipulate the AI agent or perform unauthorized actions. No suspicious external endpoints, obfuscation, or malicious execution patterns were found.
Capability Assessment
Purpose & Capability
Name/description match the implementation: Python scripts implement an Oura API client, analysis, reporting, and Telegram-based alerts. Declared requirement (python3 + OURA_API_TOKEN) is appropriate. Optional env vars (TELEGRAM_BOT_TOKEN / TELEGRAM_CHAT_ID / USER_TIMEZONE / OURA_OUTPUT_DIR) are consistent with alerting, timezone handling, and output location. Minor note: registry lists source as unknown but SKILL.md metadata and README reference a GitHub repo; you may want to verify the upstream repo before installing.
Instruction Scope
SKILL.md instructs running included Python scripts, setting OURA_API_TOKEN, and optionally configuring cron jobs that run local scripts. The runtime instructions reference only the declared env vars and local paths; they do not instruct reading unrelated system files or exfiltrating data. The cron examples invoke OpenClaw gateway commands and local shell scripts — normal for automation, but you should replace placeholder paths and chat IDs before use.
Install Mechanism
No install spec is provided (instruction-only from the registry), but the package does include many Python script files and a requirements.txt (pytz, pyyaml). There are no remote download/install actions or obscure URLs in the install metadata. Installation advice in README (git clone + pip install -r requirements.txt) is standard and proportional.
Credentials
The only required env var is OURA_API_TOKEN, which is necessary for the Oura Cloud API. Optional Telegram tokens/IDs are reasonable for alert delivery. One small concern to review: README suggests creating a token with 'select all scopes' — you should create/limit the token to the minimal read scopes required by the skill if Oura supports scoping. The README and SECURITY.md offer multiple storage suggestions (e.g., ~/.openclaw/.env, systemd user secrets); follow your own secret management policies.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or global agent configs. It stores cached data and reports under ~/.oura-analytics (or OURA_OUTPUT_DIR), which is expected for this functionality. The skill can be invoked autonomously by the agent (default platform behavior); combine that with your agent policies if you want to restrict automatic runs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install oura-analytics
  3. After installation, invoke the skill by name or use /oura-analytics
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial ClawHub release
v0.1.2
Add GitHub repo link to homepage metadata
v0.1.1
Add API token hint to description
v0.1.0
Initial release: docs alignment + events migration
Metadata
Slug oura-analytics
Version 1.0.0
License
All-time Installs 3
Active Installs 3
Total Versions 4
Frequently Asked Questions

What is Oura Ring Analytics?

Oura Ring data integration and analytics. Fetch sleep scores, readiness, activity, HRV, and trends from the Oura Cloud API. Generate automated reports, correlations with productivity, and trigger-based alerts for low recovery days. Requires OURA_API_TOKEN (get at cloud.ouraring.com). It is an AI Agent Skill for Claude Code / OpenClaw, with 2936 downloads so far.

How do I install Oura Ring Analytics?

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

Is Oura Ring Analytics free?

Yes, Oura Ring Analytics is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Oura Ring Analytics support?

Oura Ring Analytics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Oura Ring Analytics?

It is built and maintained by kesslerio (@kesslerio); the current version is v1.0.0.

💬 Comments