oura-ring

What This Skill Does

The Oura Ring skill for OpenClaw is a powerful integration tool that bridges your biometric data with the agent's decision-making capabilities. It interfaces directly with the Oura Cloud API V2 to fetch granular health metrics, including readiness scores, sleep stages, resilience markers, and stress levels. Beyond simple data retrieval, this skill features a sophisticated morning_brief.sh script that synthesizes raw API output into a tactical, human-readable summary, allowing users to make informed adjustments to their daily routines based on their physical capacity and recovery state.

Installation

To install, ensure you have the OpenClaw environment initialized. Run the command: clawhub install openclaw/skills/skills/sameerbajaj/oura-ring-skill. Once downloaded, you must create a .env file within the skills/oura-ring/ directory by copying the .env.example file. You are required to register an Oura API application at the Oura Cloud portal to generate your CLIENT_ID and CLIENT_SECRET. After obtaining an OAuth2 authorization code, exchange it for a bearer token via a POST request to the Oura OAuth endpoint. Paste this access_token into your .env file as OURA_TOKEN. Finally, create a virtual environment using python3 -m venv .venv and install the necessary dependencies from requirements.txt to ensure execution stability.

Use Cases

This skill is ideal for "Quantified Self" enthusiasts, high-performance professionals, and athletes who want to correlate their digital workload with physical recovery. It can be used to automatically adjust your calendar based on your sleep quality, flag periods of low resilience for potential burnout, or generate a "Readiness Brief" as part of your morning automation routine. By combining Oura's physiological data with OpenClaw’s planning capabilities, users can build an adaptive lifestyle operating system.

Example Prompts

1. "OpenClaw, pull my latest readiness score and suggest whether I should focus on high-intensity tasks or deep work today."
2. "Summarize my sleep quality from last night and highlight any trends in my stress levels over the past week."
3. "Generate my morning readiness brief and add a task to my to-do list if my recovery score is below 70."

Tips & Limitations

Note that Oura API access tokens have an expiration period; you will need to periodically refresh your credentials using the refresh_token provided during the OAuth flow. Ensure your .env file is excluded from version control systems (like Git) to protect your private health data. If you encounter issues with data fetch rates, be mindful of Oura's API rate limits, which are handled gracefully by the CLI tool but can be triggered by aggressive automated polling.