fitbit

What This Skill Does

The Fitbit CLI skill for OpenClaw provides a streamlined interface for interacting with your personal Fitbit health data. By integrating directly with the Fitbit Web API, this skill allows you to securely retrieve granular metrics, including step counts, sleep patterns, heart rate variability, and body weight. It abstracts away the complexities of OAuth 2.0 flow, allowing users to query their fitness history through simple, human-readable commands or via the OpenClaw agent's natural language interface.

Installation

To integrate this tool into your OpenClaw environment, execute the following command: clawhub install openclaw/skills/skills/pb3975/fitbit-health. After installation, you must perform a one-time configuration by running fitbit configure to input your unique Client ID obtained from the Fitbit developer portal. Finally, execute fitbit login to open the local authentication server at http://localhost:18787/callback, which will securely link your Fitbit account to the CLI. Tokens are stored locally in a secure ~/.config/fitbit-cli/tokens.json file, with the system handling automatic token refreshes for seamless long-term use.

Use Cases

This skill is designed for fitness enthusiasts and data-driven individuals who want to track their progress without manually checking the Fitbit app. Use this skill when you need to audit your daily activity trends, compare sleep quality over the last week, or monitor heart rate fluctuations. It is particularly useful when you need to export your data in JSON format for use in external analysis tools or automated reports, or when you simply want a quick terminal-based status update on your daily health goals.

Example Prompts

1. "How many steps did I take yesterday and how does that compare to my usual average?"
2. "Can you check my heart rate for today and output the data in JSON format?"
3. "Summarize my sleep quality for February 1st, 2026, so I can see if I got enough rest."

Tips & Limitations

The Fitbit skill defaults to the current date if no date is specified. When requesting specific historical data, always use the YYYY-MM-DD format. Keep in mind that for privacy, your tokens are stored with restricted permissions (chmod 600); do not change these settings. While the tool is excellent for retrieving data, it cannot perform write actions such as logging food or updating activity logs. If you encounter authentication issues, use fitbit status to confirm your session is still valid before re-running fitbit login.