360 Secure SkillHub
360 安全技能中心

Fitbit (Official API)

核心功能:实现Fitbit OAuth授权,本地存储并刷新令牌;获取当日活动、睡眠等健康数据,标准化为稳定JSON格式,还能生成适合聊天渠道的短摘要。典型场景:同步Fitbit数据到Wellness hub,或在聊天中分享当日健康情况。通过命令行脚本操作,输出标准化JSON、Markdown格式摘要。

gavinchengcool
gavinchengcool
热度 61.12
最近更新 2026-05-11 17:31:16
分类:自动化依赖:代码执行 / 第三方 API / 读写文件应用场景:健康 / 数据处理

安装技能

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

执行命令安装此 skill: npx secure-skills-cli add openclaw-fitbit
Metadata
name
openclaw-fitbit
description
Official Fitbit OAuth integration for OpenClaw (Tier 1). Use to connect/authorize Fitbit, store+refresh tokens locally, fetch daily activity + sleep summaries, normalize into a stable daily JSON shape for the Wellness hub, and render a short digest for any chat channel.

Fitbit (Official API)

This is a source skill. It connects to Fitbit, fetches data, normalizes it, and renders a short message.

Configuration

Required env vars:

  • FITBIT_CLIENT_ID
  • FITBIT_CLIENT_SECRET
  • FITBIT_REDIRECT_URI

Optional:

  • FITBIT_TOKEN_PATH (default: ~/.config/openclaw/fitbit/token.json)
  • FITBIT_TZ (default: Asia/Shanghai)
  • FITBIT_SCOPES (default: activity sleep heartrate profile weight)

Connect (OAuth)

  • Phone/remote mode (recommended):
python3 scripts/fitbit_oauth_login.py
  • Desktop loopback mode (optional): if authorizing on the same machine and FITBIT_REDIRECT_URI is loopback:
python3 scripts/fitbit_oauth_login.py --loopback

Fetch + normalize for a day

python3 scripts/fitbit_fetch_daily.py --date today --out /tmp/fitbit_raw_today.json
python3 scripts/fitbit_normalize_daily.py /tmp/fitbit_raw_today.json --out /tmp/fitbit_today.json
python3 scripts/fitbit_render.py /tmp/fitbit_today.json --format markdown --channel generic

References

  • API/OAuth notes: references/fitbit_api.md
  • Output schema: references/output_schema.md