A specialized skill for AI agents to retrieve and synthesize comprehensive health metrics from the Oura Ring v2 API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oura-briefing
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-briefing 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 Briefing?
The Oura Briefing skill enables AI agents to pull real-time health and wellness data directly from the Oura Ring API. It is designed to provide developers and power users with a seamless way to integrate biometric data—such as HRV balance, sleep stages, and activity scores—into their automated workflows or daily reports.
By leveraging this tool within the ecosystem of Openclaw Skills, users can transform raw JSON data from Oura into actionable human-language summaries. It acts as a bridge between high-fidelity wearable sensors and LLM-driven analysis, allowing for personalized recovery advice and health monitoring.
Oura Briefing Use Cases
- Automating daily morning health reports and readiness checks.
- Monitoring heart rate variability (HRV) trends for athletic recovery tracking.
- Triggering specific agent behaviors or notifications only after the user has confirmed waking up.
- Summarizing sleep quality and identifying patterns in sleep latency or efficiency.
How Oura Briefing Works
- The skill authenticates with the Oura v2 API using a Personal Access Token provided via environment variables or CLI flags.
- It executes a shell script that utilizes curl and jq to fetch the latest sleep, readiness, and activity endpoints.
- The data is parsed to extract key metrics like total sleep duration, recovery index, and active calories.
- If the --wake-check flag is used, it validates the presence of a bedtime_end timestamp to confirm the user is awake.
- The resulting data is returned to the agent in either a concise text summary or a raw JSON format for further processing.
Oura Briefing Setup
To use this skill, you must first obtain a Personal Access Token from the Oura Cloud dashboard. Ensure you have curl and jq installed on your system.
# Set your Oura Personal Access Token
export OURA_API_TOKEN="your_token_here"
# Run the briefing for the current day
bash scripts/oura-briefing.sh
Oura Briefing Data Schema & Taxonomy
The skill organizes health data into three primary categories. Below is the taxonomy of the metrics returned:
| Category | Key Metrics Included |
|---|---|
| Sleep | Total sleep, efficiency, REM/Deep/Light stages, latency, wake time, sleep score |
| Readiness | Readiness score, HRV balance, body temperature deviation, recovery index |
| Activity | Activity score, step count, active calories, equivalent walking distance |
Metadata includes a wake_confirmed boolean when running specific status checks.
Oura Briefing Advanced Features
- Wake Detection Gating: Use the
--wake-checkflag to prevent sending morning reports until the user's Oura Ring detects they have officially finished their sleep session. - Temporal Flexibility: Query specific historical data by passing the
--dateflag in YYYY-MM-DD format. - JSON Output Mode: Switch to
--jsonfor structured data ingestion into other Openclaw Skills or databases. - Automated Threshold Flagging: Built-in guidance for agents to highlight anomalies when scores fall below 70 or HRV drops by more than 15%.
SKILL.md
Loading
Related Openclaw Skills
AI Technical Report Social Media Generator
An automated AI marketing expert that converts technical PDF reports into platform-optimized social media content with optional AI image generation.
Strategy Pattern Implementor
Encapsulates a family of algorithms into interchangeable objects to eliminate complex if-else chains and switch statements.
WeChat Article Export Tool
A professional-grade utility to export WeChat Official Account articles into high-fidelity long images, PDF documents, or clean Markdown files.
Structural Pattern Selector
A specialized decision engine for selecting and implementing the optimal GoF structural design patterns in software development.
Zhengzhou Kewei Stepper Motor Debugging Assistant
A professional debugging tool for Zhengzhou Kewei stepper motor controllers that generates documentation and multi-platform control code.
Proactive Agent
A sophisticated architecture that shifts AI agents from passive followers into persistent, self-improving, and proactive partners.
Featured*
