A powerful interface to fetch and analyze Oura Ring health metrics including sleep, readiness, and activity scores via CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ouracli
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 ouracli 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 Ring Data Access?
This Openclaw Skills component enables AI agents to programmatically retrieve comprehensive health data from Oura Rings. By leveraging the ouracli interface, users can query detailed biometrics such as heart rate variability, sleep stages, and daily readiness scores. The skill is designed for seamless data extraction, allowing for both quick health checks and deep longitudinal analysis of personal wellness trends.
The integration handles complex date parsing and supports multiple output formats, ensuring that health data is accessible in the most useful structure for the task at hand. Whether you are tracking recovery or monitoring long-term stress, this skill provides the bridge between your wearable data and your automated workflows.
Oura Ring Data Access Use Cases
- Monitoring daily activity levels, steps, and calorie burn.
- Analyzing sleep quality and efficiency over the last 7 to 30 days.
- Checking readiness scores to optimize daily workout intensity.
- Retrieving high-resolution heart rate and blood oxygen (SpO2) data for specific date ranges.
- Generating automated health reports in JSON, Markdown, or HTML formats.
How Oura Ring Data Access Works
- The agent verifies the presence of an Oura personal access token in the environment configuration.
- Based on the user's query, the agent calculates the appropriate date range and duration format required by the CLI.
- The agent executes the ouracli command with the specified data type (e.g., sleep, activity) and date parameters.
- Results are typically requested in JSON format to facilitate structured data analysis.
- The agent interprets the data, paying close attention to specific metrics like readiness contributor scores which are normalized values.
Oura Ring Data Access Setup
First, obtain a personal access token from the Oura Cloud.
Store the token in secrets/oura.env or ~/.secrets/oura.env:
PERSONAL_ACCESS_TOKEN=your_token_here
Ensure the ouracli tool is installed and accessible in your environment path. This Openclaw Skills setup requires the environment variable to be loaded before execution to ensure secure authentication with the Oura API.
Oura Ring Data Access Data Schema & Taxonomy
| Metric | Description | Command |
|---|---|---|
| activity | Daily steps, MET values, and calories | ouracli activity |
| sleep | Sleep stages, efficiency, and heart rate | ouracli sleep |
| readiness | Readiness scores and contributor metrics | ouracli readiness |
| heartrate | Time-series heart rate (5-minute resolution) | ouracli heartrate |
| spo2 | Blood oxygen saturation data | ouracli spo2 |
| stress | Daily stress levels and analysis | ouracli stress |
Oura Ring Data Access Advanced Features
- Multi-day report generation using the all command to aggregate all health metrics at once.
- Support for various output formats including Pandas DataFrames for advanced data science workflows.
- Integrated interactive HTML chart generation for visual health summaries.
- Grouping capabilities by day or by data type (method) for structured longitudinal analysis.
- Flexible date range expressions allowing for relative queries like "7 days" or "1 month" with duration-based offsets.
SKILL.md
Loading
Related Openclaw Skills
mog (Microsoft Ops Gadget)
A comprehensive command-line interface for managing the entire Microsoft 365 ecosystem including Mail, Calendar, Drive, and Office documents.
ecto
A robust command-line interface for managing Ghost.io blog content, tags, and site settings via the Admin API.
OpenClaw Subagents Configuration
A specialized skill for designing, spawning, and managing autonomous OpenClaw subagents and multi-agent orchestration patterns.
Plan Executor
A high-integrity execution engine for Openclaw Skills that runs immutable, pre-validated plans with zero interpretation and strict termination rules.
sog: Standards Ops Gadget
A unified command-line interface for managing email, calendars, contacts, and files using open standards like IMAP, SMTP, and WebDAV.
BriteBooth Procurement Discovery
A read-only research assistant designed to automate product discovery and logistics planning for BriteBooth trade show hardware.
Featured*
