# Send Fitbit Insights to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fitbit-insights",
    "name": "Fitbit Insights",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/poisondminds/fitbit-insights",
    "canonicalUrl": "https://clawhub.ai/poisondminds/fitbit-insights",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/fitbit-insights",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fitbit-insights",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CLAWHUB-SUBMISSION.md",
      "OVERVIEW.md",
      "README.md",
      "SETUP.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "fitbit-insights",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T13:44:31.312Z",
      "expiresAt": "2026-05-08T13:44:31.312Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fitbit-insights",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fitbit-insights",
        "contentDisposition": "attachment; filename=\"fitbit-insights-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "fitbit-insights"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/fitbit-insights"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fitbit-insights",
    "downloadUrl": "https://openagent3.xyz/downloads/fitbit-insights",
    "agentUrl": "https://openagent3.xyz/skills/fitbit-insights/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fitbit-insights/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fitbit-insights/agent.md"
  }
}
```
## Documentation

### Fitbit Fitness Insights

Get AI-powered insights from your Fitbit data. Query your fitness metrics, analyze trends, and ask questions about your activity.

### Features

📊 Daily activity summaries (steps, calories, distance, active minutes)
💓 Heart rate data and zones
😴 Sleep tracking and analysis
🏃 Workout/activity logs
📈 Weekly and trend analysis
🤖 AI-powered insights and Q&A

### Prerequisites

Requires: Fitbit OAuth access token

Setup steps in references/fitbit-oauth-setup.md

### Get Profile

FITBIT_ACCESS_TOKEN="..." python3 scripts/fitbit_api.py profile

### Daily Activity

python3 scripts/fitbit_api.py daily [date]
# Examples:
python3 scripts/fitbit_api.py daily              # Today
python3 scripts/fitbit_api.py daily 2026-02-08   # Specific date

Returns: steps, distance, calories, active minutes (very/fairly/lightly/sedentary), floors

### Steps Range

python3 scripts/fitbit_api.py steps <start_date> <end_date>

Example:

python3 scripts/fitbit_api.py steps 2026-02-01 2026-02-07

Returns: total steps, average steps, daily breakdown

### Heart Rate

python3 scripts/fitbit_api.py heart [date]

Returns: resting heart rate, heart rate zones with minutes in each zone

### Sleep Data

python3 scripts/fitbit_api.py sleep [date]

Returns: duration, efficiency, start/end times, sleep stages

### Logged Activities

python3 scripts/fitbit_api.py activities [date]

Returns: workouts/activities logged (name, duration, calories, distance)

### Weekly Summary

python3 scripts/fitbit_api.py weekly

Returns: 7-day summary of steps and key metrics

### AI Insights Usage

When user asks fitness questions, use the API to fetch relevant data, then provide insights:

Example queries:

"How did I sleep last night?" → fetch sleep data, analyze quality
"Did I hit my step goal this week?" → fetch weekly summary, compare to goals
"What was my average heart rate during workouts?" → fetch heart + activities, analyze
"Am I more active on weekdays or weekends?" → fetch range data, compare patterns

Analysis approach:

Identify what data is needed
Fetch via appropriate API command
Analyze the data
Provide insights in conversational format

### Example Responses

User: "How did I do this week?"

Agent:

Fetch weekly summary
Fetch recent sleep data
Respond: "You had a solid week! Averaged 8,234 steps/day (up 12% from last week). Hit your 10k step goal 4 out of 7 days. Sleep averaged 7.2 hours with 85% efficiency. CrossFit sessions on Mon/Wed/Fri looking consistent!"

User: "Did I exercise today?"

Agent:

Fetch daily activities
Fetch daily activity summary (active minutes)
Respond: "Yes! You logged a CrossFit session this morning (45 min, 312 calories). Plus 28 very active minutes total for the day."

### Data Insights to Look For

Trends: Week-over-week changes, consistency patterns
Goals: Compare to 10k steps, exercise frequency, sleep targets
Correlations: Sleep quality vs activity, rest days vs performance
Anomalies: Unusual spikes or drops
Achievements: Personal bests, streaks, milestones

### Token Management

The skill automatically loads tokens from /root/clawd/fitbit-config.json and refreshes them when expired (every 8 hours).

Auto-refresh: Tokens are refreshed automatically - no manual intervention needed!

Manual refresh (if needed):

python3 scripts/refresh_token.py force

Override with environment variable:

export FITBIT_ACCESS_TOKEN="manual_token"

### Error Handling

Missing token: Prompt user to set FITBIT_ACCESS_TOKEN
API errors: Check token validity, may need refresh
No data: Some days may have no logged activities or missing metrics

See references/fitbit-oauth-setup.md for token management.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: poisondminds
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T13:44:31.312Z
- Expires at: 2026-05-08T13:44:31.312Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/fitbit-insights)
- [Send to Agent page](https://openagent3.xyz/skills/fitbit-insights/agent)
- [JSON manifest](https://openagent3.xyz/skills/fitbit-insights/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/fitbit-insights/agent.md)
- [Download page](https://openagent3.xyz/downloads/fitbit-insights)