SuperAPI AI 工具集

oura-analytics

数据与分析

查看项目

更新于 10-15 23:45

技能介绍

用途:该技能用于集成 Oura Ring 数据并做分析,可从 Oura Cloud API 获取睡眠、准备度、活动、HRV 等指标,分析恢复趋势,将睡眠质量与生产力或事件关联,设置低准备度告警,并生成每日、每周或每月健康报告。

主要能力:提供 oura_api.py(含 OuraClient、OuraAnalyzer、OuraReporter 类)、alerts.py(基于阈值的通知)、weekly_report.py(周报生成)以及 daily_summary.py、daily-note.py 等入口。支持按日期范围拉取数据、计算平均指标与趋势。

使用方式:需设置环境变量 OURA_API_TOKEN。示例:export OURA_API_TOKEN="your_personal_access_token";python {baseDir}/scripts/oura_api.py sleep --days 7;python {baseDir}/scripts/oura_api.py readiness --days 7;python {baseDir}/scripts/oura_api.py report --type weekly;告警示例:python {baseDir}/scripts/alerts.py --days 7 --readiness 60 --efficiency 80。可选环境变量包括 KESSLER_TELEGRAM_BOT_TOKEN(回退 TELEGRAM_BOT_TOKEN)、TELEGRAM_CHAT_ID、USER_TIMEZONE、OURA_OUTPUT_DIR。自动化通过 OpenClaw 网关的 cron 配置,而非本仓库,可用 openclaw cron add 添加每日晨报、每周睡眠报告和每日 Obsidian 笔记任务。

适用场景:个人健康数据追踪、恢复趋势分析、睡眠与事件关联、自动化健康报告与告警。

限制:需自备 Oura 个人访问令牌;cron 任务需在 OpenClaw 网关配置并替换路径与聊天 ID 占位符;Telegram 投递的 cron 提示不要写成“Execute bash ...”,否则可能进入需审批的 exec 路径而无法完成聊天投递。其他收费、平台与效果信息暂未提供。