ClawHub

Text to Song

Other

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.

duplicate of @sthk-mbm/texttomusic

Install

openclaw skills install text-to-song

🎵 AI Music Studio

✨ Describe your vision, let AI compose the melody ✨

🚀 Get Your API Key

  1. Visit 👉 MBM官网 and sign up 📝
  2. Go to My Account → Claw key 🔑
  3. Click Create Key and copy it ✂️
  4. ⚠️ Important: Save your key immediately — it won't be shown again!

⚙️ Configure Your Key

  1. Open OpenClaw app 📱
  2. Click Skills in the left menu 📋
  3. Find text-to-music 🎶
  4. Click Configure or Environment Variables ⚡
  5. Enter your Claw key (xxx...) in the apiKey field 🔐
  6. Save — you're ready to go! 🎉
  7. 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:

  1. If user provides description: Use their description, default to vocals (false) unless they explicitly say "instrumental" or "pure music"
  2. 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.