介绍
# Oura Analytics
## 快速开始
```bash # 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 weekly ```
## 适用场景
在以下情况使用此技能： - 获取 Oura Ring 指标（睡眠、准备度、活动量、HRV） - 分析随时间变化的恢复趋势 - 将睡眠质量与生产力/事件进行关联 - 设置准备度低的自动警报 - 生成每日/每周/每月健康报告
## 核心工作流
### 1. 数据获取 ```bash 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)) PY ```
### 2. 趋势分析 ```bash export 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) PY ```
### 3. 警报 ```bash python {baseDir}/scripts/alerts.py --days 7 --readiness 60 --efficiency 80 ```
## 环境变量
必需： - `OURA_API_TOKEN`
可选（用于警报/报告/时区/输出）： - `KESSLER_TELEGRAM_BOT_TOKEN`（回退到 `TELEGRAM_BOT_TOKEN`） - `TELEGRAM_CHAT_ID` - `USER_TIMEZONE` - `OURA_OUTPUT_DIR`
## 脚本
- `scripts/oura_api.py` - Oura Cloud API 封装，包含 OuraAnalyzer 和 OuraReporter 类 - `scripts/alerts.py` - 基于阈值的通知（命令行：`python {baseDir}/scripts/alerts.py --days 7 --readiness 60`） - `scripts/weekly_report.py` - 每周报告生成器
## 参考资料
- `references/api.md` - Oura Cloud API 文档 - `references/metrics.md` - 指标定义与解读
## 自动化（Cron 任务）
Cron 任务在 OpenClaw 的网关中配置，而不是在此仓库中。请将这些添加到您的 OpenClaw 设置中：
### 每日晨报（上午 8:00） ```bash 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" ```
### 每周睡眠报告（周日上午 8:00） ```bash 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" ```
### 每日 Obsidian 笔记（上午 8:15） ```bash 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" ```
**注意：** 请将 `/path/to/your/` 替换为您的实际路径，并将 `<YOUR_TELEGRAM_CHAT_ID>` 替换为您的 Telegram 频道/群组 ID。