- name
- text-to-music
- description
- AI music generation assistant powered by MakebestMusic. Use when user wants to create AI-generated music, songs, or audio tracks. Perfect for content creators, musicians, and anyone wanting custom AI music. Triggers on requests like "create a song", "generate music", "makebestmusic", "AI music", "write a melody", etc.
- version
- 1.2.0
- metadata
- openclaw
- emoji
- 🎵
- requires
- env
- ["apiKey"]
- primaryEnv
- apiKey
🎵 AI Music Studio
✨ Describe your vision, let AI compose the melody ✨
🚀 Get Your API Key
- Visit 👉 MBM官网 and sign up 📝
- Go to My Account → Claw key 🔑
- Click Create Key and copy it ✂️
- ⚠️ Important: Save your key immediately — it won't be shown again!
⚙️ Configure Your Key
- Open OpenClaw app 📱
- Click Skills in the left menu 📋
- Find text-to-music 🎶
- Click Configure or Environment Variables ⚡
- Enter your Claw key (xxx...) in the apiKey field 🔐
- Save — you're ready to go! 🎉
- Restart openclaw
💫 How It Works
Just tell me what kind of song you want! For example:
- "Create a happy pop song about summer"
- "Generate an upbeat K-pop dance track"
- "Make a relaxing piano piece for studying"
Instrumental or Vocals?
- If you want vocals (song with singing): just describe your song
- If you want pure music (no singing): include words like "instrumental", "pure music", or "no vocals" in your request
What to include in your description:
- 🎼 Genre: Pop, Electronic, Classical, Rock, Jazz, R&B, Hip-hop, K-pop, Chinese-style
- 😊 Mood: Happy, Sad, Romantic, Energetic, Calm, Exciting
- 💖 Theme: Love, Dreams, Nature, Night, Adventure
- 🎸 Instruments: Piano, Guitar, Drums, Synth, Strings
I'll default to vocals if you don't specify!
💬 Example Requests
With Vocals (Default)
- *"Create a happy pop song about summer with synth and guitar"*
- *"Generate an upbeat K-pop dance track about love"*
- *"Write a romantic R&B song about heartbreak"*
- *"Make an energetic electronic song for a workout"*
Instrumental
- *"Create an instrumental piano piece for studying"*
- *"Generate a relaxing ambient track, no vocals"*
- *"Make a pure music classical piano piece"*
Check Status
- *"How's my song going?"*
- *"Is my song ready?"*
🎵 Generating a Song
When user requests a song:
- If user provides description: Use their description, default to vocals (false) unless they explicitly say "instrumental" or "pure music"
- If user says "create a song" or "generate music" without description: Ask them what kind of song they want
Then run:
node ~/.openclaw/workspace/skills/text-to-music/scripts/generate.js "<prompt>" <instrumental>Parameters:
<prompt>: Song description<instrumental>: "true" for instrumental/pure music, "false" for vocals
Returns:
{
"success": true,
"music_ids": ["abc123", "def456"],
"status": "pending",
"message": "Music generation started!"
}🔍 Query Task Status
Check generation status:
node ~/.openclaw/workspace/skills/text-to-music/scripts/query.js "<music_id_1> <music_id_2> ..."Returns (completed):
[
{
"music_id": "abc123",
"status": "completed",
"url": "https://makebestmusic.com/app/shared-music/abc123"
}
]Returns (processing):
[
{
"music_id": "abc123",
"status": "pending"
}
]Status handling:
- ✅
completed: Present with celebration! Show title, duration (if available), and clickable link - ⏳
pending: Tell user it's still processing, suggest they ask again later - ❌
failed: Explain failure, suggest retrying with different description
⏱️ Generation Time
- ⏱️ Typical time: 2-3 minutes
- 💡 Ask "How's my song going?" to check the status
❓ Troubleshooting
Q: "API Key invalid" error?
Make sure the key is copied completely (includes "sk-" prefix). No extra spaces. Try generating a new key if issues persist.
Q: How long does it take?
Usually 2-3 minutes. Ask me "How's my song going?" to check!
Q: What if generation fails?
Try a simpler description. Avoid special characters. Try again with different keywords.