MiniMax Music Generation OpenClaw Skill

Generate AI music using MiniMax Music 2.5 API. Use when the user wants to: (1) generate instrumental/pure music, (2) generate songs with lyrics, (3) generate...

v1.0.0 Recently Updated Updated 3 days ago

Installation

clawhub install minimax-music

Requires npm i -g clawhub

53

Downloads

1

Stars

0

current installs

0 all-time

1

Versions

EU EU-Hosted Inference API

Power your OpenClaw skills with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

MiniMax Music Generation

Generate AI music using MiniMax Music 2.5 API.

Prerequisites

Set the MINIMAX_API_KEY environment variable:

export MINIMAX_API_KEY="your-api-key-here"

Quick Start

# Generate instrumental music
python3 ~/.openclaw/workspace/skills/minimax-music/scripts/minimax_music.py create \
  --prompt "Piano, Relaxing, Meditative" \
  --instrumental \
  --download ~/Music

# Generate song with lyrics
python3 ~/.openclaw/workspace/skills/minimax-music/scripts/minimax_music.py create \
  --prompt "Pop, Upbeat, Celebratory" \
  --lyrics "[Verse]\n阳光洒满大地\n[Chorus]\n快乐每一天" \
  --download ~/Music

# Generate lyrics first
python3 ~/.openclaw/workspace/skills/minimax-music/scripts/minimax_music.py lyrics \
  --prompt "一首关于春天的歌" \
  --output lyrics.txt

Music Generation Parameters

Parameter Description Default
--prompt Music style description (required) -
--lyrics Lyrics text with [Verse], [Chorus] markers -
--lyrics-file Path to lyrics file -
--instrumental Generate instrumental music (no vocals) false
--sample-rate Audio quality: 44100, 48000 44100
--bitrate Audio bitrate: 128000, 256000, 320000 256000
--format Output format: mp3, wav, flac mp3
--download Directory to save audio file -
--model Model ID music-2.5

Prompt Examples

Instrumental Music

# Relaxing piano
--prompt "Piano, Relaxing, Meditative, Soft, Ambient"

# Electronic ambient
--prompt "Electronic, Ambient, Atmospheric, Synthesizer, Chill"

# Orchestral
--prompt "Orchestra, Cinematic, Epic, Strings, Brass"

# Jazz
--prompt "Jazz, Smooth, Saxophone, Piano, Night Club"

Songs with Lyrics

# Chinese pop
--prompt "Mandopop, Emotional, Ballad" \
--lyrics "[Verse]\n夜深人静\n思念着你\n[Chorus]\n心中的爱\n永不改变"

# English pop
--prompt "Pop, Upbeat, Energetic" \
--lyrics "[Verse]\nWalking down the street\nFeeling the beat\n[Chorus]\nLet's celebrate tonight"

Lyrics Format

Use section markers to structure the song:

[Intro]
(Instrumental opening)

[Verse]
Main lyrics here

[Pre-Chorus]
Build-up section

[Chorus]
Main hook/refrain

[Bridge]
Contrast section

[Outro]
Ending section

Daily Quota

MiniMax Token Plan subscriptions include:

  • music-2.5: 7 generations/day (Plan 199)
  • Quota resets daily at midnight

Sending Audio via Feishu

After generating music, send to user's Feishu:

import requests

# 1. Upload audio file
with open("music.mp3", "rb") as f:
    upload_resp = requests.post(
        "https://open.feishu.cn/open-apis/im/v1/files",
        headers={"Authorization": f"Bearer {TENANT_ACCESS_TOKEN}"},
        files={"file": ("music.mp3", f, "audio/mpeg")},
        data={"file_type": "stream", "file_name": "music.mp3"}
    )
file_key = upload_resp.json()["data"]["file_key"]

# 2. Send file message
requests.post(
    "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
    headers={"Authorization": f"Bearer {TENANT_ACCESS_TOKEN}", "Content-Type": "application/json"},
    json={
        "msg_type": "file",
        "content": json.dumps({"file_key": file_key}),
        "receive_id": USER_OPEN_ID
    }
)

Rules

  1. Always check MINIMAX_API_KEY is set before API calls.
  2. Use --instrumental for pure music without vocals.
  3. Default to 44100 Hz, 256 kbps, MP3 format for good quality and compatibility.
  4. Download immediately - audio URLs expire after some time.
  5. Respect daily quota - inform user if they've hit their limit.
  6. Provide audio file to user after generation (download + share via Feishu if applicable).

Statistics

Downloads 53
Stars 1
Current installs 0
All-time installs 0
Versions 1
Comments 0
Created Apr 7, 2026
Updated Apr 7, 2026

Latest Changes

v1.0.0 · Apr 7, 2026

Initial release: AI music generation with MiniMax Music 2.5 API. Supports instrumental music, songs with lyrics, and lyrics-only generation.

Quick Install

clawhub install minimax-music
EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Customer Support