Oura戒指数据获取

技能简介

该技能通过Oura Cloud API V2连接Oura智能戒指，获取用户的准备度评分、睡眠数据及7天趋势，生成结构化的晨间健康简报。

能做什么

• 拉取当日准备度（Readiness）与睡眠（Sleep）核心指标
• 计算过去7天的准备度变化趋势
• 输出战术性晨间建议（Morning Readiness Brief）
• 支持压力管理能力映射（Resilience Tracking）

使用说明

步骤1：安装依赖

python3 -m venv skills/oura-ring/.venv
source skills/oura-ring/.venv/bin/activate
python -m pip install -r skills/oura-ring/requirements.txt

步骤2：配置环境变量

cp skills/oura-ring/.env.example skills/oura-ring/.env

编辑.env文件，填入OURA_TOKEN（必需）和可选的OURA_BASE_URL。

步骤3：获取OAuth2令牌

1. 访问Oura开发者后台创建应用
2. 设置Redirect URI（本地测试可用http://localhost:8080/callback）
3. 拼接授权URL并访问，获取code参数
4. 用curl交换code获取access_token，写入.env文件

步骤4：运行查询

# 准备度数据
python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty readiness

# 睡眠数据
python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty sleep

# 7天趋势
python3 skills/oura-ring/cli.py --env-file skills/oura-ring/.env --format json --pretty trends

# 晨间简报（推荐）
./skills/oura-ring/scripts/morning_brief.sh

无令牌验证模式：python3 skills/oura-ring/cli.py --mock readiness --format json

输入与输出

见下方输入与输出表格。

风险提示

• Access Token存在过期机制，需定期用refresh_token续期
• .env文件含敏感凭证，禁止提交至代码仓库
• API调用受Oura速率限制约束
• 健康数据仅供参考，不构成医疗诊断

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/sameerbajaj/oura-ring-skill/SKILL.md
来源类型：GitHub开源技能