lastfm

What This Skill Does

The Last.fm skill empowers your OpenClaw AI agent to serve as a deep-dive music intelligence interface. By integrating directly with the Last.fm API, the agent retrieves detailed listening history, statistical summaries of musical taste, and discovery data. Whether you want to know what is currently playing, investigate your most-listened-to artists of the last year, or cross-reference your loved tracks, this skill translates raw scrobbling data into actionable insights and summaries. It essentially acts as a personal music archivist, providing immediate access to historical trends and granular listening metadata.

Installation

To enable this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/gumadeiras/lastfm. After installation, ensure you have configured your environment variables. You must add your unique LASTFM_API_KEY and your LASTFM_USER handle to your shell profile or your ~/.clawdbot/.env file. Without these credentials, the API calls will fail to authenticate, preventing the agent from fetching your data.

Use Cases

This skill is perfect for users who track their listening habits religiously and want a conversational way to query their data. You can use it to generate "end of year" style summaries, track personal growth in musical taste, or perform quick lookups on what you were listening to during specific time periods. It is also highly effective for discovery, as it allows the agent to analyze your top artists and provide suggestions based on the metrics retrieved from your account history.

Example Prompts

1. "What are my top five most played artists over the last six months, and how many plays do they each have?"
2. "Can you check my recent listening history? I want to know if I have any tracks marked as currently playing right now."
3. "Summarize my top albums of this week and let me know if any of my 'loved' tracks were among them."

Tips & Limitations

Note that this skill is strictly a read-only interface for your Last.fm data; it cannot modify your account or submit new scrobbles. Always ensure your API key is kept secure and not hardcoded into scripts. Because the skill relies on the Last.fm API, performance depends on their server availability. Additionally, queries using wide time frames (like 'all time') may return large datasets that the agent must parse, so be specific with your time ranges to get faster, more relevant results.