oura-ring

# Oura Ring

This skill syncs your daily health data from Oura Ring into readable markdown files.

## Syncing Data

Sync today's data:

```bash
uv run {baseDir}/scripts/sync_oura.py
```

Sync a specific date:

```bash
uv run {baseDir}/scripts/sync_oura.py --date 2026-02-07
```

Sync the last N days:

```bash
uv run {baseDir}/scripts/sync_oura.py --days 7
```

## Reading Health Data

Health files are stored at `{baseDir}/health/YYYY-MM-DD.md` — one file per day.

To answer health or fitness questions, read the relevant date's file from the `{baseDir}/health/` directory. If the file doesn't exist for the requested date, run the sync command for that date first.

## Cron Setup

Schedule the sync script to run every morning using OpenClaw's `cron` tool so your health data stays up to date automatically.

# Oura Ring — OpenClaw Skill

An [OpenClaw](https://openclaw.ai) skill that syncs your daily health data from Oura Ring into markdown files. OpenClaw can then reference your health and fitness data in conversation.

## What it syncs

- **Sleep** — duration, stages (deep/light/REM/awake), sleep score, bedtime/wake time
- **Readiness** — score, temperature deviation, HRV balance, recovery index
- **Activity** — steps, calories, distance, active minutes
- **Stress** — high stress minutes, recovery minutes
- **Heart Rate** — resting, min, max
- **SpO2** — blood oxygen percentage
- **Workouts** — type, duration, distance, calories

## Example output

```markdown
# Health — February 8, 2026

## Sleep: 7h 12m
Deep: 1h 30m | REM: 1h 57m | Light: 3h 45m | Awake: 0h 15m
Sleep Score: 82
Bedtime: 23:15 | Wake: 06:27
Efficiency: 92 | Restfulness: 85 | Timing: 78

## Readiness: 85
Temp Deviation: +0.3°C
HRV Balance: 90 | Resting HR: 88 | Recovery Index: 92
Sleep Balance: 78 | Activity Balance: 85

## Activity: 8,432 steps | 2,100 cal
Distance: 6.2 km | Active: 45 min

## Stress
High Stress: 120 min | Recovery: 340 min

## Heart Rate
Resting: 58 bpm | Min: 48 bpm | Max: 142 bpm

## SpO2: 96%

## Workouts
- **Running** — 28:15, 5.0 km, 320 cal
```

Sections are only included when data is available.

## Setup

### Requirements

- Python 3.10+
- [uv](https://docs.astral.sh/uv/) (no pip install needed — dependencies are inline)
- An Oura Ring account

### Environment variables

```bash
export OURA_TOKEN="your_personal_access_token"
```

Get your token at https://cloud.ouraring.com/personal-access-tokens

### Run it

```bash
# Sync today
uv run scripts/sync_oura.py

# Sync a specific date
uv run scripts/sync_oura.py --date 2026-02-07

# Sync the last 7 days
uv run scripts/sync_oura.py --days 7
```

Markdown files are written to `health/YYYY-MM-DD.md`.

### Install as an OpenClaw skill

```bash
ln -s /path/to/ouraskill ~/.openclaw/skills/oura-ring
```

### Cron

Schedule the sync to run...