https://github.com/rickybloomfield/OuraClaw
Oura skill for OpenClaw
https://github.com/rickybloomfield/OuraClaw
Last synced: 3 months ago
JSON representation
Oura skill for OpenClaw
- Host: GitHub
- URL: https://github.com/rickybloomfield/OuraClaw
- Owner: rickybloomfield
- License: mit
- Created: 2026-02-01T14:17:44.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-06T16:44:20.000Z (4 months ago)
- Last Synced: 2026-02-07T00:37:08.023Z (4 months ago)
- Language: TypeScript
- Size: 72.3 KB
- Stars: 16
- Watchers: 0
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-openclaw-plugins - ouraclaw - Oura Ring integration — sleep, readiness, activity, stress data with scheduled summaries. By [@rickybloomfield](https://github.com/rickybloomfield). `openclaw plugins install @rickybloomfield/ouraclaw` (Skills vs Plugins: What's the Difference? / Bundled Plugins)
- awesome-openclaw - rickybloomfield/OuraClaw - Oura-Integration fuer Readiness-, Schlaf- und Aktivitaets-Summaries.  (Plugins und Integrationen)
- awesome-openclaw-plugins - OuraClaw
README
# OuraClaw
Oura Ring plugin and skill for [OpenClaw](https://openclaw.ai). Brings your sleep, readiness, activity, and stress data into your agent conversations.
## Features
- **Agent tool** (`oura_data`) — lets the agent fetch Oura Ring data on your behalf
- **Skill** — teaches the agent how to interpret scores, format summaries, and answer health questions
- **Scheduled summaries** — optional morning and evening health recaps delivered to your preferred channel
- **Background token refresh** — keeps your Oura connection alive without manual intervention
## Prerequisites
- [OpenClaw](https://openclaw.ai) installed and configured
- An [Oura Ring](https://ouraring.com) account with data
## Installation
```bash
# From npm
npm install -g @rickybloomfield/ouraclaw
openclaw plugins install @rickybloomfield/ouraclaw
# Or from source
git clone https://github.com/rickybloomfield/OuraClaw.git
cd OuraClaw && npm install && npm run build
openclaw plugins install -l .
```
## Setup
Run the interactive setup wizard:
```bash
openclaw ouraclaw setup
```
The wizard will walk you through:
1. **Create an Oura application**
- Go to [https://developer.ouraring.com](https://developer.ouraring.com)
- Navigate to "My Applications" and create a new app
- Set the redirect URI to `http://localhost:9876/callback`
2. **Enter credentials** — paste your Client ID and Client Secret
3. **Authorize** — a browser window opens to complete the OAuth flow
4. **Choose delivery channel** — pick iMessage, Slack, Discord, Telegram, or use the default active channel
5. **Set schedule** — configure morning and evening summary times and timezone, or skip scheduled messages
## Usage
Once set up, just ask your agent about your health data:
- "How did I sleep last night?"
- "What's my readiness score?"
- "How active was I today?"
- "Show me my sleep trends for the past week"
- "Give me a full health summary"
## CLI Commands
```bash
openclaw ouraclaw setup # Run the setup wizard
openclaw ouraclaw status # Show connection status and config
openclaw ouraclaw test # Fetch today's data to verify the connection
```
## Scheduled Summaries
If enabled during setup, OuraClaw creates two cron jobs:
- **Morning** (default 7:00 AM) — sleep score, readiness, stress, and a personalized note
- **Evening** (default 9:00 PM) — activity summary, readiness, stress, sleep recap, and a wind-down note
Manage them with:
```bash
openclaw cron list # See all cron jobs
openclaw cron run ouraclaw-morning --force # Manually trigger morning summary
```
Re-running `openclaw ouraclaw setup` replaces existing cron jobs without duplication.
## Development
```bash
npm install
npm run build # Compile TypeScript
npm run dev # Watch mode
```
## License
MIT