Oura戒指数据获取

技能简介

通过ouracli命令行工具连接Oura Ring智能戒指，提取用户的健康与运动数据。支持活动量、睡眠质量、心率变异性、准备度评分、压力水平等多维度指标查询。

业务背景

健康管理团队可通过Oura戒指批量获取员工或客户的体征数据，用于疲劳监测、运动效果评估及个性化健康干预。无需开发复杂接口，命令行即可导出标准化报告，降低健康数据分析的技术门槛。

落地案例：某企业 wellness 部门为200名参与健身挑战的员工统一采集数据：设定日期范围为30天，选择activity和sleep类型，输出Markdown格式周报。HR直接获得带图表的睡眠效率与活动量对比，识别出持续睡眠不足的高风险人群并安排健康访谈。

能做什么

• 获取每日步数、卡路里消耗、MET值等活动数据
• 查询睡眠阶段分布、效率评分及夜间心率曲线
• 读取准备度评分及其各项贡献因子
• 导出5分钟分辨率的心率时序数据
• 查看血氧饱和度与每日压力水平
• 生成HTML可视化报告或JSON结构化数据

使用说明

安装步骤

1. 确保系统已安装Python环境
2. 执行 pip install ouracli 安装命令行工具
3. 访问 Oura云控制台 申请个人访问令牌
4. 将令牌写入环境变量：创建 secrets/oura.env 文件，内容为 PERSONAL_ACCESS_TOKEN=your_token_here

基础用法

# 今日活动数据（JSON格式）
ouracli activity today --json

# 近7天睡眠数据
ouracli sleep "7 days" --json

# 指定日期范围的活动记录
ouracli activity "2025-12-01 30 days" --json

# 导出HTML周报
ouracli all "7 days" --by-day --html > report.html

关键提示：日期范围含空格时必须加引号；双日期格式不被支持，需换算为”起始日期+天数”形式。

输入与输出

见下方输入与输出表格。

风险提示

• 准备度数据中的resting_heart_rate字段为0-100的评分值，非实际静息心率BPM
• 单日查询可能因时区问题返回空结果，建议扩展为2天范围
• 数据新鲜度依赖戒指同步状态，长期未同步则无法获取近期记录
• 历史数据可查询范围受用户订阅等级限制

来源信息

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