MoodTunes

Tell OpenClaw your mood and get music recommendations — maps emotions to Spotify genres, energy, and vibes.

Install

openclaw plugins install clawhub:openclaw-moodtunes

openclaw-moodtunes

Created by Riya Verma (@iriyaverma)

Tell OpenClaw your mood and get Spotify music recommendations. Maps emotions to genres, energy levels, and vibes — then serves up tracks that match exactly how you're feeling.

Install

bash

openclaw plugins install clawhub:openclaw-moodtunes

Setup

You need free Spotify API credentials:

Go to developer.spotify.com/dashboard
Create an app (any name, any description)
Copy the Client ID and Client Secret
Add them to your OpenClaw config:

json5

{
  plugins: {
    entries: {
      "moodtunes": {
        config: {
          spotifyClientId: "your-client-id",
          spotifyClientSecret: "your-client-secret",
          defaultTrackCount: 5,
        },
      },
    },
  },
}

Agent Tools

Tool	Description
`mood_play`	Get tracks based on a mood (happy, sad, chill, energetic, etc.)
`mood_detect`	Describe your situation naturally and get auto-detected mood + tracks
`mood_mix`	Blend two moods together for a unique mix
`mood_genre`	Pick specific genres directly with optional energy/valence tuning
`mood_list`	Show all supported moods, aliases, and genres

Examples

Just talk naturally to the agent:

"I'm feeling chill, play me some music"
"Play something for a workout"
"I just got promoted, give me some tracks!"
"Mix romantic and chill vibes"
"Play me some jazz with low energy"
"It's a rainy Sunday afternoon, what should I listen to?"

Supported Moods

Mood	Genres	Also works with
happy	pop, dance	joyful, cheerful, excited, ecstatic
sad	acoustic, indie, singer-songwriter	depressed, heartbroken, crying, down
energetic	edm, dance, electronic	pumped, hyped, fired up
chill	chill, ambient, lo-fi	relaxed, calm, peaceful, laid back
angry	metal, hard-rock, punk	furious, mad, rage, frustrated
romantic	r-n-b, soul, jazz	love, in love, passionate
focused	classical, ambient, study	studying, working, productive
party	dance, pop, hip-hop	celebration, friday, turn up, lit
nostalgic	indie, folk, classic-rock	throwback, memories, missing someone
anxious	ambient, new-age, classical	stressed, nervous, worried, overwhelmed
confident	hip-hop, rap, pop	powerful, boss, empowered
melancholy	indie, alternative, piano	bittersweet, longing, wistful
workout	edm, hip-hop, rock	gym, running, exercise, training
sleepy	ambient, new-age, classical	tired, exhausted, bedtime

CLI

bash

openclaw moodtunes moods    # list all supported moods

How It Works

You say your mood (or describe your situation)
The plugin maps it to Spotify audio parameters (energy, valence, danceability, tempo)
It calls the Spotify Recommendations API with matching genres and parameters
You get a table of tracks with direct Spotify links

License

MIT