Oura (API v2)

这是OpenClaw的一级Oura Ring数据源，核心功能为通过Oura个人访问令牌连接账号，获取睡眠、恢复、活动等v2数据，标准化为稳定的每日JSON格式，同时生成适用于聊天渠道的短摘要。可通过脚本执行数据获取、标准化、渲染操作，输出原始数据JSON、标准化JSON及Markdown格式摘要，适用于为Wellness Hub提供健康数据或在聊天渠道推送健康摘要，需配置指定环境变量，支持指定日期。

gavinchengcool

热度 56.76

最近更新 2026-05-11 17:31:16

分类：数据依赖：代码执行 / 读写文件 / 第三方 API应用场景：数据处理 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openclaw-oura

Metadata

name: openclaw-oura
description: Oura Ring data source for OpenClaw (Tier 1). Use to connect an Oura account using an Oura Personal Access Token, fetch Oura v2 usercollection data (sleep, readiness, activity), normalize it into a stable daily JSON shape for the Wellness hub, and render a short summary message for any chat channel.

Oura (Personal Access Token)

This is a source skill. It fetches Oura data and outputs normalized daily JSON + a human-readable digest. It does not hardcode the destination channel.

Configuration

Required env var:

OURA_ACCESS_TOKEN

Optional:

OURA_TZ (default: Asia/Shanghai)

Fetch + normalize for a day

python3 scripts/oura_fetch_daily.py --date today --out /tmp/oura_raw_today.json
python3 scripts/oura_normalize_daily.py /tmp/oura_raw_today.json --out /tmp/oura_today.json
python3 scripts/oura_render.py /tmp/oura_today.json --format markdown --channel generic

Notes

API reference: references/oura_api.md
Output schema: references/output_schema.md