A Python-powered skill for fetching Oura Ring sleep, readiness, and resilience data through the Oura V2 API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oura-ring-skill
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-ring-skill 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 Integration?
The Oura Ring skill for Openclaw Skills is a reference implementation designed to interface with the Oura Cloud V2 API. It allows developers and AI agents to programmatically retrieve biometric data such as sleep scores, readiness metrics, and resilience tracking. This skill acts as a technical bridge between wearable health data and automated workflows, enabling a deeper understanding of user recovery and daily capacity.
By leveraging Openclaw Skills, users can automate the collection of health insights to drive personalized AI responses. Whether you are building a personal health dashboard or an automated coaching assistant, this skill provides the necessary tools to access and interpret physiological data points directly from the Oura ecosystem.
Oura Ring Integration Use Cases
- Generating an automated Morning Readiness Brief to optimize daily task planning based on recovery scores.
- Tracking long-term health improvements by analyzing 7-day sleep and activity trends.
- Integrating real-time stress management data into productivity environments using resilience tracking.
- Developing automated health alerts or recommendations based on readiness score fluctuations.
How Oura Ring Integration Works
- The skill authenticates with the Oura Cloud V2 API using an OAuth2 bearer token stored in a local environment file.
- Users interact with the skill via a Python-based CLI, passing arguments to specify the desired data type (sleep, readiness, trends, etc.).
- The CLI performs a GET request to the specific Oura API endpoints, such as /v2/usercollection/sleep.
- The raw biometric data is processed and can be output as formatted JSON for machine consumption or pretty-printed for human review.
- A dedicated shell script wrapper can be executed to synthesize the raw data into a tactical morning brief.
Oura Ring Integration Setup
- Set up a virtual environment and install the required Python dependencies:
python3 -m venv skills/oura-ring/.venv
source skills/oura-ring/.venv/bin/activate
python -m pip install -r skills/oura-ring/requirements.txt
- Configure your environment variables by copying the example file:
cp skills/oura-ring/.env.example skills/oura-ring/.env
- Obtain an OAuth2 access token from the Oura Cloud dashboard and add it to your
.envfile asOURA_TOKEN=your_token_here.
Oura Ring Integration Data Schema & Taxonomy
| Metric Type | API Endpoint | Description |
|---|---|---|
| Readiness | /readiness | Daily readiness scores including recovery contributors. |
| Sleep | /sleep | Detailed sleep stages, duration, and efficiency metrics. |
| Trends | /readiness | A paginated 7-day lookback of readiness data. |
| Resilience | /resilience | Mapping of your body's capacity to handle physiological stress. |
| Stress | /stress | Real-time markers for daily stress levels. |
Oura Ring Integration Advanced Features
- Built-in mock mode to allow testing and workflow verification without consuming API rate limits or requiring a live token.
- Morning Readiness Brief script for instant, tactical recommendations based on the latest biometric scores.
- Support for pagination and trend analysis to visualize health changes over a 7-day rolling window.
- Flexible CLI architecture that supports custom environment file locations and pretty-print JSON formatting for Openclaw Skills users.
SKILL.md
Loading
Related Openclaw Skills
ChatGPT History Import
A utility to migrate ChatGPT conversation history into OpenClaw's memory search by converting exports into searchable SQLite vector databases.
MemePickup Wingman
An AI-powered dating assistant that generates personalized openers, conversation replies, and profile analysis using the MemePickup API.
n8nops
An expert-level automation agent for building, debugging, and monitoring n8n workflows through natural language and the n8n REST API.
Intros
A specialized social network integrated into your AI agent that facilitates professional discovery, connection management, and secure messaging.
Reader Deep Dive
A sophisticated intelligence briefing skill that bridges the gap between your current reading list and your historical knowledge archive.
RoughCut (macOS)
A macOS-native automation skill that generates Final Cut Pro rough-cut timeline variants from raw talking-head footage without cloud media uploads.
Featured*
