360 Secure SkillHub
360 安全技能中心

Oura Briefing

该 Skill 通过 bash 脚本调用 Oura Ring v2 API，抓取指定日期的睡眠、准备度（HRV、体温偏差、恢复指数）和活动数据，输出文字简报或 JSON，并支持醒来检测作为晨报触发条件。需提供 Oura 个人访问令牌，依赖 curl 与 jq。

silas-agent573
silas-agent573
热度 38.69
最近更新 2026-05-11 17:41:54
分类：生活依赖：代码执行 / 第三方 API应用场景：健康 / 报告撰写 / 摘要总结 / 自动化脚本

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add oura-briefing
Metadata
name
oura-briefing
description
Fetch and summarize Oura Ring v2 sleep, readiness, and activity data. Use when the user asks about their sleep score, HRV, readiness, recovery, or Oura metrics. Delivers a concise daily health briefing. Requires OURA_API_TOKEN set in the environment or passed via --token.
metadata
{"openclaw":{"requires":{"bins":["curl","jq"]}}}

Oura Briefing

Fetch and summarize daily health metrics from the Oura Ring API (v2).

Setup

Set your Oura Personal Access Token:

export OURA_API_TOKEN="your_token_here"

Get a token at: https://cloud.ouraring.com/personal-access-tokens

Usage

# Today's briefing
bash scripts/oura-briefing.sh

# Specific date
bash scripts/oura-briefing.sh --date 2024-01-15

# JSON output
bash scripts/oura-briefing.sh --json

# Use a token directly
bash scripts/oura-briefing.sh --token YOUR_TOKEN

What it returns

  • Sleep: total sleep, efficiency, deep/REM/light breakdown, latency, wake time, score
  • Readiness: readiness score, HRV balance, body temperature deviation, recovery index
  • Activity: activity score, steps, active calories, equivalent walking distance

Agent guidance

When a user asks about sleep, readiness, HRV, or recovery:

  1. Run bash scripts/oura-briefing.sh (requires OURA_API_TOKEN in environment)
  2. Parse the output and present a plain-language summary
  3. Flag anything below their normal range (sleep < 70, readiness < 70, HRV drop > 15%)
  4. Suggest actionable adjustments if scores are low (bedtime, wind-down, recovery day)

Wake detection

The script exits 0 with a wake_confirmed field when the user has woken up today (bedtime_end present in latest long_sleep session). Use this as a gate before sending morning reports.

bash scripts/oura-briefing.sh --wake-check
# exit 0 = awake, exit 1 = not yet