Strava API Integration for Openclaw

An official Strava OAuth integration designed to securely connect, authorize, and retrieve workout and activity data for AI agents.

swang62
v1.0.1
Apr 19, 2026
1
1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install strava-api

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install strava-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Strava API Integration?

The Strava API skill provides a robust bridge between the Strava fitness platform and the Openclaw ecosystem. It handles the complexities of OAuth2 authentication flow, including secure token storage and automatic refresh cycles, ensuring that your AI agent maintains persistent access to fitness metrics.

This skill is designed as a source-only integration, focusing on fetching high-fidelity activity data such as runs, rides, and swims. By normalizing this output, it enables other Openclaw Skills to generate training summaries, calculate weekly mileage, or populate a centralized wellness hub with consistent, actionable data.

Strava API Integration Use Cases

  • Synchronizing daily workout data to personal wellness dashboards or health trackers.
  • Generating automated weekly training summaries and mileage reports via AI agents.
  • Feeding normalized fitness data into larger data analytics pipelines for performance overviews.
  • Triggering automated social updates or performance reviews based on new Strava activities.

How Strava API Integration Works

  1. The user configures the environment with official Strava API credentials (Client ID and Secret).
  2. An OAuth handshake is initiated via a dedicated login script, providing a secure access token.
  3. The skill stores and manages the token locally, handling refreshes automatically when required.
  4. Users or agents call the fetch scripts to retrieve activity data for specific dates or ranges.
  5. The raw API response is parsed and output as normalized JSON for use by downstream Openclaw Skills.

Strava API Integration Setup

First, ensure you have your Strava API credentials from the Strava developer dashboard. Set the following environment variables:

export STRAVA_CLIENT_ID="your_id"
export STRAVA_CLIENT_SECRET="your_secret"
export STRAVA_REDIRECT_URI="your_callback_url"

Run the OAuth login script to authorize the connection:

# For remote/phone authorization (standard)
python3 scripts/strava_oauth_login.py

# For local browser authorization
python3 scripts/strava_oauth_login.py --loopback

Strava API Integration Data Schema & Taxonomy

The skill organizes its persistent data and activity exports as follows:

Data Type Location / Format Description
OAuth Tokens ~/.config/openclaw/strava/token.json Stores access and refresh tokens securely.
Activity Data JSON (/tmp/ or custom path) Normalized workout data including distance, duration, and type.
Metadata Internal Registry Tracks timezone settings and last-sync timestamps.

Strava API Integration Advanced Features

  • Support for flexible timezones via the STRAVA_TZ configuration for accurate 'today' and 'yesterday' queries.
  • Dual-mode OAuth flow supporting both headless/remote servers and local desktop environments.
  • Channel-agnostic data delivery, allowing the normalized JSON output to be consumed by any secondary automation or UI.
  • Granular date range fetching to facilitate historical data backfills for Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*