用途：Oura Analytics 用于从 Oura Cloud API 拉取 Oura Ring 指标（睡眠、准备度、活动、HRV），分析恢复趋势，将睡眠质量与生产力或事件关联，设置低准备度告警，并生成每日、每周或每月健康报告。
主要能力：提供 OuraClient 获取指定日期区间的睡眠与准备度数据；OuraAnalyzer 计算平均指标与趋势；OuraReporter 生成报告。附带脚本包括 oura_api.py（API 封装）、alerts.py（基于阈值的通知）、weekly_report.py（周报生成器）。参考文档 references/api.md 与 references/metrics.md 说明 API 与指标定义。
使用方式：先设置环境变量 export OURA_API_TOKEN="your_personal_access_token"。获取最近 7 天睡眠：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。也可在 Python 中设置 PYTHONPATH 后导入 OuraClient、OuraAnalyzer 进行数据获取与趋势分析。
环境变量：必需 OURA_API_TOKEN；可选 KESSLER_TELEGRAM_BOT_TOKEN（回退 TELEGRAM_BOT_TOKEN）、TELEGRAM_CHAT_ID、USER_TIMEZONE、OURA_OUTPUT_DIR，用于告警、报告、时区与输出。
自动化：Cron 任务在 OpenClaw 网关中配置，而非本仓库。可用 openclaw cron add 添加每日晨报、每周睡眠报告、每日 Obsidian 笔记等任务，需替换实际路径与 Telegram 聊天 ID。
限制：需自行提供 Oura 个人访问令牌；定时任务依赖 OpenClaw 环境；资料未提供具体收费、价格、平台支持范围或效果保证。