Oura戒指数据查询

技能简介

本技能通过命令行接口调用Oura Ring API（V2），获取用户的睡眠、活动、恢复状态及生理指标数据，支持个人健康数据的自动化查询与分析。

业务背景

面向健康管理、保险风控及企业员工福利场景，自动获取Oura戒指用户的睡眠、活动与恢复数据，实现健康状态的持续追踪。无需人工录入即可掌握用户身体准备度，为个性化健康干预、动态保费评估或员工疲劳管理提供数据支撑，降低健康风险识别成本。

落地案例：某企业 wellness 平台接入本技能后，员工授权即可同步Oura数据。HR按周查看团队平均睡眠评分与恢复状态，识别高疲劳风险人员并主动推送调休建议；保险公司则在投保环节调用该技能，结合申请人历史活动与心率变异性数据，辅助评估生活方式风险等级，优化核保决策流程。

能做什么

• 查询每日睡眠评分、效率及详细睡眠阶段（含睡眠图）
• 获取活动评分、步数、运动消耗等日常活动数据
• 查看恢复状态评分，了解身体准备度
• 读取连续心率时间序列数据
• 获取血氧饱和度（SpO2）、压力水平、心血管年龄、VO2 Max等指标
• 查询锻炼记录、小憩时段、最佳就寝建议
• 获取用户个人资料及戒指硬件配置信息

使用说明

步骤1：构建CLI工具

cd ~
git clone https://github.com/ruhrpotter/oura-cli.git
cd oura-cli
go build -o oura ./cmd/oura

步骤2：创建Oura OAuth应用

1. 访问 Oura开发者门户
2. 创建新应用，设置回调URI为 http://localhost:8080/callback
3. 记录生成的Client ID和Client Secret

步骤3：完成认证

export OURA_CLIENT_ID="your_client_id"
export OURA_CLIENT_SECRET="your_client_secret"
./oura auth login

浏览器将自动打开完成OAuth授权，令牌保存在 ~/.config/oura-cli/config.json。

基本用法

./oura get <category> [flags]

常用分类：personal（个人资料）、sleep（睡眠）、activity（活动）、readiness（恢复）、heartrate（心率）、spo2（血氧）、stress（压力）等。

日期参数：--start YYYY-MM-DD 必需，--end YYYY-MM-DD 可选。相对日期（如”昨天”、”上周”）需转换为绝对日期格式。

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管OAuth Client Secret，避免泄露导致账户数据被非法访问
• 令牌文件存储在本地配置文件，注意文件权限设置
• API返回的健康数据仅供参考，不作为医疗诊断依据
• 日期范围过大可能导致请求超时或数据量过大
• 认证过期时需重新执行登录流程

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ruhrpotter/oura/SKILL.md
来源类型：GitHub仓库