基于官方 Oura API 的个人健康数据同步工具，将睡眠、心率等生物数据安全导入本地 Markdown，助你掌握身体状况。
说明：
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/` 目录的磁盘占用情况，长期累积可能产生大量文件。
