A comprehensive integration for Oura Ring that automates health data retrieval, trend analysis, and recovery alerting.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oura-analytics
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install oura-analytics using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Oura Analytics?
The Oura Analytics skill bridges the gap between your Oura Ring wearable and your automated workflows. By leveraging the Oura Cloud API, it allows developers and biohackers to programmatically access sleep, readiness, activity, and heart rate variability (HRV) metrics. This Openclaw Skills component is designed to help users understand their recovery patterns and correlate biological data with daily productivity or specific lifestyle events.
With this tool, you can move beyond the standard app interface to create custom dashboards, generate specialized health reports, and integrate biometric data into larger personal data ecosystems. It serves as a robust foundation for anyone looking to build data-driven health habits through automated analysis and smart notifications within the Openclaw Skills framework.
Oura Analytics Use Cases
- Automating the retrieval of sleep scores and readiness levels for daily health briefings.
- Correlating HRV and recovery metrics with work productivity or training loads.
- Setting up proactive alerts for low recovery days to adjust daily schedules automatically.
- Generating comprehensive weekly or monthly health reports for long-term trend visualization.
- Synchronizing health data with personal knowledge management systems like Obsidian for journaling.
How Oura Analytics Works
- Authenticates with the Oura Cloud API using a user-provided personal access token.
- Retrieves granular biometric data types including sleep, activity, and readiness scores for specific date ranges.
- Processes raw JSON data through the OuraAnalyzer to calculate averages and identify historical trends.
- Triggers alerts or generates formatted reports based on user-defined thresholds for metrics like efficiency or readiness.
- Executes scheduled tasks via cron jobs within the gateway to deliver insights to communication channels like Telegram.
Oura Analytics Setup
To get started, obtain your Personal Access Token from cloud.ouraring.com.
# Set your Oura API token environment variable
export OURA_API_TOKEN="your_personal_access_token"
# Install dependencies if necessary and fetch recent sleep data
python scripts/oura_api.py sleep --days 7
Ensure python3 is available in your environment to execute the core analysis scripts provided in this Openclaw Skills repository.
Oura Analytics Data Schema & Taxonomy
The skill organizes data through a structured Python wrapper, allowing for easy extraction and transformation of Oura Cloud records.
| Data Type | Description | Key Metrics |
|---|---|---|
| Sleep Data | Detailed sleep stage and quality metrics | score, efficiency, rem, deep, hrv |
| Readiness | Daily recovery readiness level | score, temperature deviation, resting_hr |
| Activity | Movement and calorie expenditure | goal_met, daily_movement, steps |
| Trends | Calculated historical comparisons | average_hrv, score_trends |
Metadata is stored according to the Openclaw Skills specification, ensuring seamless integration with the wider agent ecosystem.
Oura Analytics Advanced Features
- Integrated OuraAnalyzer class for custom statistical trend analysis and metric averaging.
- Multi-channel notification support including Telegram bot integration for mobile alerts.
- Support for hybrid reporting formats that combine raw data with AI-driven narrative summaries.
- Automated synchronization scripts for Obsidian to facilitate daily health journaling.
- Extensible CLI for threshold-based alerting, such as notifying the user when readiness falls below a specific score.
SKILL.md
Loading
Related Openclaw Skills
Coding Agent Skill
A robust orchestration layer for running interactive AI coding agents like Codex, Claude Code, and Gemini via a controlled terminal environment.
MinerU PDF Parser
A local, CPU-based PDF parser that transforms complex documents into AI-ready Markdown and JSON formats.
lobster-jobs
A specialized migration tool for converting OpenClaw cron jobs into deterministic Lobster workflows featuring approval gates and resumable execution.
Klutch Programmable Finance
An advanced financial integration that enables AI agents and developers to interact with Klutch programmable credit cards through a secure GraphQL API.
PyMuPDF PDF Parsing
A lightning-fast local tool for converting PDF documents into Markdown and JSON formats with support for image and table extraction.
Shorten
A streamlined URL shortening skill that leverages is.gd to provide permanent short links without the need for authentication.
METADATA
Featured*
