Text to Song

AI music generation assistant powered by MakebestMusic. Use when user wants to create AI-generated music, songs, or audio tracks. Perfect for content creator...

Security Scan

The skill's code, runtime instructions, and requested credential (apiKey) are consistent with an AI music-generation integration (MakebestMusic) and show no signs of incoherent or unrelated access.

Purpose & Capability

Name/description advertise MakebestMusic music generation and the included scripts call makebestmusic API endpoints and require a single apiKey credential — this is coherent and expected.

Instruction Scope

SKILL.md instructs the agent to run the bundled node scripts which only (a) read the apiKey env var, (b) optionally read MBM_API_BASE if set, and (c) POST/GET to makebestmusic endpoints. The instructions do not ask the agent to read unrelated files, other credentials, or transmit data to unexpected endpoints.

Install Mechanism

No install step or remote downloads. The skill is instruction-only with two local JS scripts that are executed by node; nothing is pulled from untrusted URLs or written during install.

Credentials

The skill only requires a single apiKey (declared as primaryEnv) which matches the code usage. One optional env var (MBM_API_BASE) is referenced by the scripts but not declared in requires.env — harmless but note that if an operator sets MBM_API_BASE it will redirect API calls to a custom endpoint.

Persistence & Privilege

always is false, the skill does not request permanent/force-loaded access or attempt to modify other skills or system-wide configs in the provided files/instructions.

Assessment

This skill appears to be what it claims: it needs a MakebestMusic apiKey and runs the included node scripts to call MakebestMusic APIs. Before installing: (1) Only provide an apiKey you obtained from makebestmusic.com and avoid reusing high-privilege or unrelated keys. (2) Be aware the scripts honor an optional MBM_API_BASE environment variable — don't set that to an unknown host or it could redirect API traffic. (3) Review the MakebestMusic account settings and rotate/delete the key if you later stop using the skill. (4) If you have strict security requirements, run the scripts in a sandboxed environment or inspect network traffic to confirm calls go to makebestmusic.com.

🎵 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.