oura-analytics

What This Skill Does

The oura-analytics skill integrates the Oura Cloud API into your OpenClaw environment, acting as a bridge between your physical recovery data and your digital workflow. It is designed to pull raw health metrics—such as sleep duration, readiness scores, heart rate variability (HRV), and activity levels—directly from your Oura Ring. Beyond simple retrieval, the skill includes specialized classes like OuraAnalyzer and OuraReporter that process these metrics to identify patterns, calculate moving averages, and generate actionable health summaries. By leveraging this data, users can correlate their peak performance periods with their recovery metrics, allowing for data-driven scheduling. The skill supports automated alerting systems, allowing you to define thresholds for readiness or sleep efficiency, which can trigger notifications via Telegram to keep you informed of your physical status throughout the day.

Installation

To begin using the Oura Analytics skill, first ensure you have obtained your personal access token from cloud.ouraring.com. Once you have the token, install the skill via the OpenClaw management CLI:

clawhub install openclaw/skills/skills/kesslerio/oura-analytics

After installation, set your environment variable: export OURA_API_TOKEN="your_personal_access_token"

For advanced automation, configure your reporting preferences using the USER_TIMEZONE and OURA_OUTPUT_DIR environment variables. If you wish to receive automated alerts, define your TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID within your OpenClaw configuration file.

Use Cases

This skill is highly versatile for users who prioritize health-conscious productivity. Use it to:

• Automated Morning Briefings: Automatically send a daily summary of your previous night's sleep to your Telegram account before you start your workday.
• Performance Correlation: Compare your sleep data against calendar events to see if specific evening meetings or late-night work correlate with lower readiness scores the following morning.
• Recovery-Based Scheduling: If your readiness score falls below a user-defined threshold, the skill can trigger alerts, prompting you to automate the rescheduling of intense tasks to a later date.
• Long-term Trend Analysis: Identify seasonal or monthly trends in your HRV and sleep consistency to optimize your long-term health and training recovery protocols.

Example Prompts

1. "OpenClaw, fetch my readiness score from the last 3 days and let me know if I am in a good state to handle a high-intensity workload today."
2. "Run the weekly Oura analytics report and highlight any significant drops in my average HRV over the last 14 days."
3. "Set up an alert to notify my Telegram if my sleep efficiency drops below 75% for two consecutive nights."

Tips & Limitations

• API Rate Limits: The Oura API has specific rate limits; be mindful when running frequent scripts or large date range queries.
• Data Privacy: Since this skill handles sensitive biometric data, ensure your OURA_API_TOKEN is kept secure and not hardcoded in version-controlled scripts.
• Connectivity: Real-time data sync relies on the Oura Ring successfully syncing with the Oura App on your mobile device before the API reflects the most recent metrics.
• Timezones: Always verify that your USER_TIMEZONE is set correctly to ensure that the daily reporting logic aligns with your actual sleep window.