OpenClaw + Spotify

Prerequisites

• OpenClaw running (see our deployment guide)
• A Spotify account (free or Premium)
• Spotify Premium required for full playback control

Step 1: Create a Spotify App

1. Go to developer.spotify.com/dashboard
2. Log in with your Spotify account
3. Click Create App
4. Fill in the details:
- App name: OpenClaw - App description: AI assistant integration - Website: Your domain or http://localhost
5. Click Create
6. Click Settings → Basic Information
7. Copy the Client ID and Client Secret

Step 2: Configure Redirect URI

1. In your app settings, click Edit Settings
2. Add Redirect URIs:
- http://localhost:3000/oauth/callback (local) - https://your-domain.com/oauth/callback (production)
3. Click Add then Save

Step 3: Set User Access

1. In your app settings, find User Management
2. Add your Spotify email as a test user
3. This is required while your app is in Development mode

Configuration

Add the Spotify channel to your OpenClaw config:

# In your openclaw config
channels:
  spotify:
    enabled: true
    client_id: "YOUR_CLIENT_ID"
    client_secret: "YOUR_CLIENT_SECRET"
    redirect_uri: "https://your-domain.com/oauth/callback"

Or via environment variables in your docker-compose.yml:

environment:
  - SPOTIFY_ENABLED=true
  - SPOTIFY_CLIENT_ID=your_client_id
  - SPOTIFY_CLIENT_SECRET=your_client_secret
  - SPOTIFY_REDIRECT_URI=https://your-domain.com/oauth/callback

Step 4: Authorize Access

1. Restart OpenClaw: docker compose restart openclaw
2. Visit the OAuth URL shown in logs or OpenClaw UI
3. Log in to Spotify
4. Grant the requested permissions
5. You'll be redirected back with a success message

Verification

Try asking OpenClaw to interact with Spotify:

"Play 'Bohemian Rhapsody' on Spotify"
"What's currently playing?"
"Pause the music"
"Skip to next track"
"Search for jazz playlists"
"Add this song to my Liked Songs"

Check logs for API calls:

docker compose logs -f openclaw | grep -i spotify

Common Issues

No active device: Spotify requires an active device for playback control. Open Spotify on your phone, computer, or speaker first.

Premium required: Free accounts have limited API access. Playback control requires Spotify Premium. Search and playlist management work on free accounts.

Token expired: Spotify access tokens expire after 1 hour. OpenClaw automatically refreshes tokens using the refresh token.

App in development: While in development mode, only users you add in the dashboard can authorize. Request quota extension for production use.