MuseStream Skill

AI music generation and streaming. Give the user a shareable player URL — music generates and plays continuously in their browser. All songs are saved to a local library.

Provider-agnostic — Sonauto is the default. Adding new music generation APIs requires only a config entry.

Features

• Continuous streaming player — Agent sends user a URL; browser streams AI-generated music song after song with no interruption
• Auto-queue — Automatically requests the next song after 120 seconds of playback while the browser window stays active; click "Stop Stream" or close the window to stop queuing and save your Sonauto credits
• Shareable links — Player URLs can be shared externally; expose the server via a reverse proxy (e.g., Nginx, Caddy) or a tunnel (e.g., ngrok, Cloudflare Tunnel) with HTTPS and authentication to keep your stream secure
• Context-aware prompts — The agent uses its own LLM to interpret user intent and real-world context (weather, mood, activity, location, traffic) into effective music generation prompts; the server also provides a rule-based fallback via /api/context
• Persistent library — All generated songs are saved locally with metadata (title, tags, lyrics) and browsable via a built-in player
• Mobile context UI — Form at /context-ui for sharing context from any device
• Background save on stop — Clicking Stop finishes saving the current song before ending
• Messenger bot integration — Connect MuseStream to your messaging bots (Telegram, Discord, Slack, etc.) so you can request AI music streams directly from a chat message and receive a playable link in reply

[!CAUTION] Remember to click Stop Stream or close the browser window when you're done listening. The auto-queue will keep requesting new songs every 120 seconds, which consumes your Sonauto credits.

Setup for Agent (first time)

0. Clone the repo

git clone https://github.com/asriverwang/openclaw-musestream.git ~/.openclaw/skills/openclaw-musestream

All subsequent commands assume MuseStream is located at ~/.openclaw/skills/openclaw-musestream. Adjust paths if you cloned it elsewhere.

1. Get Sonauto API key

Guide the user to sign up at https://sonauto.ai and copy their API key.

2. Configure environment

Once the user provides their key:

cp config.example.json config.json

Set the values in config.json:

{
  "SONAUTO_API_KEY": "<user's key>",
  "MUSIC_PROVIDER": "sonauto",
  "MUSESTREAM_OUTPUT_DIR": "<user's preferred path>",
  "MUSESTREAM_PORT": <user's preferred port>
}

Ask the user where they want generated songs saved. If they don't specify, remind them the default is ~/Music/MuseStream. Ask the user which port to use. If they don't specify, remind them the default is 5001. The agent should pick an available port to avoid conflicts.

3. Install dependencies

pip install -r requirements.txt