oura-analyticsOura Ring data integration and analytics. Fetch sleep scores, readiness, activity, HRV, and trends from the Oura Cloud API. Generate automated reports, correlations with productivity, and trigger-based alerts for low recovery days. Requires OURA_API_TOKEN (get at cloud.ouraring.com).
Install via ClawdBot CLI:
clawdbot install kesslerio/oura-analytics# Set Oura API token
export OURA_API_TOKEN="your_personal_access_token"
# Fetch sleep data (last 7 days)
python {baseDir}/scripts/oura_api.py sleep --days 7
# Get readiness summary
python {baseDir}/scripts/oura_api.py readiness --days 7
# Generate weekly report
python {baseDir}/scripts/oura_api.py report --type weeklyUse this skill when:
export PYTHONPATH="{baseDir}/scripts"
python - <<'PY'
from oura_api import OuraClient
client = OuraClient(token="YOUR_TOKEN")
sleep_data = client.get_sleep(start_date="2026-01-01", end_date="2026-01-16")
readiness_data = client.get_readiness(start_date="2026-01-01", end_date="2026-01-16")
print(len(sleep_data), len(readiness_data))
PYexport PYTHONPATH="{baseDir}/scripts"
python - <<'PY'
from oura_api import OuraClient, OuraAnalyzer
client = OuraClient(token="YOUR_TOKEN")
sleep_data = client.get_sleep(start_date="2026-01-01", end_date="2026-01-16")
readiness_data = client.get_readiness(start_date="2026-01-01", end_date="2026-01-16")
analyzer = OuraAnalyzer(sleep_data, readiness_data)
avg_sleep = analyzer.average_metric(sleep_data, "score")
avg_readiness = analyzer.average_metric(readiness_data, "score")
trend = analyzer.trend(sleep_data, "average_hrv")
print(avg_sleep, avg_readiness, trend)
PYpython {baseDir}/scripts/alerts.py --days 7 --readiness 60 --efficiency 80Required:
OURA_API_TOKENOptional (used for alerts/reports/timezone/output):
KESSLER_TELEGRAM_BOT_TOKEN (fallback to TELEGRAM_BOT_TOKEN)TELEGRAM_CHAT_IDUSER_TIMEZONEOURA_OUTPUT_DIRscripts/oura_api.py - Oura Cloud API wrapper with OuraAnalyzer and OuraReporter classesscripts/alerts.py - Threshold-based notifications (CLI: python {baseDir}/scripts/alerts.py --days 7 --readiness 60)scripts/weekly_report.py - Weekly report generatorreferences/api.md - Oura Cloud API documentationreferences/metrics.md - Metric definitions and interpretationsCron jobs are configured in OpenClaw's gateway, not in this repo. Add these to your OpenClaw setup:
openclaw cron add \
--name "Daily Oura Health Report (Hybrid)" \
--cron "0 8 * * *" \
--tz "America/Los_Angeles" \
--session isolated \
--wake next-heartbeat \
--deliver \
--channel telegram \
--target "<YOUR_TELEGRAM_CHAT_ID>" \
--message "Run the daily Oura health report with hybrid format: Execute bash /path/to/your/scripts/daily-oura-report-hybrid.sh"openclaw cron add \
--name "Weekly Oura Sleep Report" \
--cron "0 8 * * 0" \
--tz "America/Los_Angeles" \
--session isolated \
--wake next-heartbeat \
--deliver \
--channel telegram \
--target "<YOUR_TELEGRAM_CHAT_ID>" \
--message "Run weekly Oura sleep report: bash /path/to/your/oura-weekly-sleep-alert.sh"openclaw cron add \
--name "Daily Obsidian Note" \
--cron "15 8 * * *" \
--tz "America/Los_Angeles" \
--session isolated \
--wake next-heartbeat \
--message "Create daily Obsidian note with Oura data. Run: source /path/to/venv/bin/activate && python /path/to/daily-note.py"Note: Replace /path/to/your/ with your actual paths and
Generated Feb 24, 2026
Individuals track sleep, readiness, and activity metrics from their Oura Ring to optimize daily routines and recovery. They generate weekly reports to identify trends and correlate sleep quality with productivity, using alerts to avoid overtraining on low readiness days.
Companies integrate Oura Ring data into employee wellness initiatives to monitor workforce health trends and reduce burnout. They analyze aggregated readiness and sleep scores to tailor interventions, such as flexible scheduling or stress management workshops, based on recovery data.
Coaches and athletes use Oura Ring analytics to track recovery metrics like HRV and sleep scores, adjusting training loads accordingly. Automated alerts flag low readiness days to prevent injuries and enhance performance through data-driven decisions.
Researchers collect longitudinal Oura Ring data from participants to study sleep patterns, recovery trends, and correlations with health outcomes. They automate report generation for analysis, aiding in clinical trials or lifestyle intervention studies.
Healthcare providers monitor patients' recovery metrics post-surgery or during chronic illness management using Oura Ring data. Alerts trigger for low readiness scores, enabling timely interventions and reducing hospital readmissions through continuous health tracking.
Offer a SaaS platform where users pay a monthly fee to access advanced Oura Ring analytics, automated reports, and personalized insights. Revenue is generated through tiered subscriptions, with premium features like correlation analysis and integration with other health apps.
Sell customized Oura Ring analytics packages to corporations for employee wellness programs, including dashboards, trend reports, and alert systems. Revenue comes from one-time setup fees and ongoing service contracts based on company size and features.
Provide consulting services to help individuals or organizations integrate Oura Ring data with existing systems, such as productivity tools or health records, and set up automated workflows. Revenue is earned through hourly rates or project-based pricing for implementation and training.
š¬ Integration Tip
Ensure the OURA_API_TOKEN is securely stored and set up cron jobs in OpenClaw for automated reporting, using environment variables like TELEGRAM_BOT_TOKEN for alert delivery.
Automatically update Clawdbot and all installed skills once daily. Runs via cron, checks for updates, applies them, and messages the user with a summary of what changed.
Full desktop computer use for headless Linux servers. Xvfb + XFCE virtual desktop with xdotool automation. 17 actions (click, type, scroll, screenshot, drag,...
Essential Docker commands and workflows for container management, image operations, and debugging.
Tool discovery and shell one-liner reference for sysadmin, DevOps, and security tasks. AUTO-CONSULT this skill when the user is: troubleshooting network issues, debugging processes, analyzing logs, working with SSL/TLS, managing DNS, testing HTTP endpoints, auditing security, working with containers, writing shell scripts, or asks 'what tool should I use for X'. Source: github.com/trimstray/the-book-of-secret-knowledge
Deploy applications and manage projects with complete CLI reference. Commands for deployments, projects, domains, environment variables, and live documentation access.
Monitor topics of interest and proactively alert when important developments occur. Use when user wants automated monitoring of specific subjects (e.g., product releases, price changes, news topics, technology updates). Supports scheduled web searches, AI-powered importance scoring, smart alerts vs weekly digests, and memory-aware contextual summaries.