oura-ring

💍 智能戒指健康数据管家

🥥42总安装量 10评分人数 6
100% 的用户推荐

基于官方 Oura API 的个人健康数据同步工具,将睡眠、心率等生物数据安全导入本地 Markdown,助你掌握身体状况。

A

基本安全,请在特定环境下使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 代码安全规范,无 eval/exec/system/subprocess 等危险函数,无注入漏洞
  • ✅ API Token 通过环境变量获取,无硬编码,且类型标记为 secret
  • ✅ 数据仅写入本地文件,无上传至第三方服务器,符合数据最小化原则
  • ✅ 使用官方 Oura API 客户端库,依赖版本锁定,无动态代码加载
  • ⚠️ 需在多用户环境妥善保管 OURA_TOKEN,避免环境变量泄露

使用说明

Oura Ring 数据同步技能专为智能戒指用户设计,可将睡眠评分、准备度指数、日常活动量、静息心率、压力水平、血氧饱和度及运动记录等生物数据自动同步至本地 Markdown 文件。

核心用法:通过 uv run 执行 Python 脚本,支持同步当日数据(默认)、指定日期(--date)或最近 N 天(--days)的历史记录。数据以日期为单位生成独立 Markdown 文件,存储于 {baseDir}/health/ 目录。用户可通过 OpenClaw 的 cron 工具设置每日自动同步,确保健康数据保持最新。查询时直接读取对应日期的 Markdown 文件即可获取结构化健康指标。

显著优点:首先,数据主权完全掌控,所有信息仅存储于本地文件系统,不上传至任何第三方服务器,彻底避免云端隐私泄露风险。其次,官方接口保障可靠性,直接调用 Oura 官方 API 及官方 Python 客户端库,数据来源权威准确。再者,Markdown 格式极具可读性,生成的文件可直接阅读或配合其他笔记软件使用,便于长期健康趋势分析。最后,自动化支持完善,结合 cron 定时任务可实现"无感同步",每日醒来即可查看完整的健康报告。

潜在局限:该技能仅服务于 Oura Ring 设备持有者,无法兼容 Apple Watch、Garmin 等其他可穿戴设备。配置过程需要用户自行前往 Oura Cloud 生成 Personal Access Token 并配置环境变量,对非技术用户存在一定门槛。此外,技能为单向同步(只读),无法将修改回传至 Oura 系统,也不支持多用户数据管理。依赖管理使用 uv 工具,需要预先安装 Python 3.10+ 环境。

适合人群:Oura Ring 长期佩戴者、量化自我(Quantified Self)实践者、注重数据隐私希望本地备份健康记录的用户,以及需要通过 OpenClaw 助手进行自然语言健康查询的极客用户。特别适合希望将生物数据与日记、工作日志结合管理的知识管理爱好者。

使用风险:主要风险在于 Token 安全管理,若 OURA_TOKEN 环境变量在多用户共享环境或日志中泄露,他人可能获取您的健康数据,建议定期在 Oura Cloud 后台轮换 Token。性能方面,大量历史数据同步可能受限于 Oura API 的速率限制。此外,依赖的 oura-ring PyPI 包需要保持更新以适配 API 变更,长期未更新可能导致同步失败。建议定期检查 {baseDir}/health/ 目录的磁盘占用情况,长期累积可能产生大量文件。

oura-ring 内容

文件夹图标scripts文件夹
手动下载zip · 6.2 kB
sync_oura.pytext/plain
请选择文件