oura-ring

What This Skill Does

The Oura Ring skill for OpenClaw is a powerful automation tool designed to bridge the gap between your wearable health hardware and your local knowledge base. By connecting to the Oura Cloud API, this skill automatically fetches and parses complex biometric data—including sleep architecture, readiness scores, activity logs, heart rate variability, stress levels, and SpO2 metrics—and archives them into structured, human-readable markdown files. By storing data in your local environment, you maintain complete ownership of your health history while enabling your AI agent to query your biometric trends over time.

Installation

To integrate the Oura Ring skill, use the OpenClaw CLI to install the package directly from the source repository:

clawhub install openclaw/skills/skills/freakyflow/oura-ring

Once installed, ensure your environment variables (specifically your Oura API personal access token) are correctly configured. You can automate daily data collection by scheduling a cron job that executes the sync script: uv run {baseDir}/scripts/sync_oura.py. This ensures your daily logs are ready for analysis every morning.

Use Cases

This skill is perfect for users who want to move beyond the limitations of the official Oura app. Common use cases include:

• Trend Analysis: Ask your AI to compare sleep quality metrics against workout intensity over the past month.
• Journaling Automation: Automatically populate daily health summaries within your digital journal or Obsidian vault.
• Health Coaching: Use the AI to explain why your readiness score dropped based on the activity and sleep data synced from the previous days.

Example Prompts

1. "Check my sleep score and readiness from February 7th, 2026, and tell me if my stress levels were higher than the previous day."
2. "Review the last 7 days of activity data. Did my daily step count correlate with my recovery heart rate?"
3. "Summarize my workout performance for this week based on the data in my health directory."

Tips & Limitations

• Proactive Syncing: If you are asking a question about a date that hasn't been synced yet, OpenClaw may need to run the sync script first. Ensure your cron jobs are active to avoid missing data.
• File Structure: All data is strictly formatted in the {baseDir}/health/YYYY-MM-DD.md pattern. If you move these files, the AI may struggle to locate your historical data.
• Data Granularity: While the skill captures a broad spectrum of data, it is limited by the API's current output. Ensure you have the necessary permissions granted in the Oura Cloud portal to access all fields.