fitbit-analytics

What This Skill Does

The fitbit-analytics skill serves as a comprehensive bridge between your wearable health data and the OpenClaw agent ecosystem. It enables seamless retrieval and analysis of key fitness metrics—including step counts, heart rate variability, sleep quality, and daily caloric expenditure—directly from the Fitbit Web API. Beyond simple data fetching, this skill allows users to generate automated daily briefings and weekly health summaries, providing actionable insights into personal wellness trends without requiring manual navigation of the Fitbit dashboard. By utilizing environment-based authentication, the skill maintains a secure connection to your personal health cloud, transforming raw data points into structured reports that can be analyzed by other OpenClaw agents or exported as JSON for third-party integration.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/kesslerio/fitbit-analytics

Once installed, you must configure your Fitbit API credentials as environment variables. Ensure the following keys are exported in your session:

• FITBIT_CLIENT_ID
• FITBIT_CLIENT_SECRET
• FITBIT_ACCESS_TOKEN
• FITBIT_REFRESH_TOKEN

Use Cases

• Morning Health Briefing: Automatically generate a summary of yesterday’s active zone minutes, sleep cycles, and today’s current activity progress.
• Trend Analysis: Compare physical activity and heart rate metrics over 7, 30, or 90-day intervals to monitor progress toward fitness goals.
• Health Monitoring: Integrate with custom alert agents to trigger notifications if resting heart rate fluctuates significantly or if daily step goals remain unmet.
• Weekly Reporting: Generate automated weekly health reports for personal record-keeping or coaching analysis.

Example Prompts

1. "OpenClaw, pull my activity summary for the last 7 days and generate a JSON report comparing my steps against my weekly average."
2. "What was my sleep quality like last night, and did I reach my target of 45 active zone minutes yesterday?"
3. "Generate a brief health summary for today and alert me if my resting heart rate has increased by more than 5% compared to last week."

Tips & Limitations

• Data Granularity: Note that this skill leverages the public Fitbit Web API. Some premium features, such as deep-dive 'Cardio Load' data found in the official mobile app, are not accessible via this interface.
• Security: Keep your refresh tokens secure. Do not share your environment files, as they provide broad read access to your health profile.
• Consistency: For the most accurate reporting, ensure your device is synced to the Fitbit app before requesting data through the agent.
• Automation: Consider running fitbit_briefing.py via a cron job or scheduled task for a hands-off morning health routine.