suno-music

What This Skill Does

The suno-music skill serves as an advanced interface for the gcui-art/suno-api, enabling OpenClaw AI agents to generate high-fidelity music, songs, and instrumental tracks directly through the Suno v5 engine. This skill bridges the gap between natural language requests and audio synthesis by automating interactions with a self-hosted Suno API server. It manages the entire lifecycle of music production: generating lyrical content, defining complex style and genre tags, triggering custom generation requests, and handling the polling and downloading of produced audio files.

Installation

1. Ensure you have Node.js installed on your machine.
2. Clone the repository: git clone https://github.com/gcui-art/suno-api && cd suno-api && npm install && npm run build.
3. Configure your environment variables in a .env file, specifically including your Suno cookie and an optional 2Captcha key to prevent authentication interruptions.
4. Launch the API server using PORT=3100 npm start.
5. Install the OpenClaw skill via the terminal using the command: clawhub install openclaw/skills/skills/alfred-pennyworth-ai/suno-music.
6. Verify connectivity by running a health check: curl http://localhost:3100/api/get_limit.

Use Cases

• Occasion-based songwriting: Creating personalized birthday songs, celebratory anthems, or unique roasts for friends.
• Creative Assistance: Generating lyrics based on a specific theme or mood, which can be reviewed and edited before final production.
• Background Music Creation: Producing instrumental tracks for presentations, videos, or atmospheric needs.
• Genre-Specific Composition: Crafting songs with precise control over musical elements like instrumentation, tempo, and vocal styles.

Example Prompts

1. "Make a catchy, upbeat pop song about my cat Whiskers celebrating his third birthday, featuring happy lyrics and acoustic guitar."
2. "Write some melancholic lyrics about a rainy day in London, and then generate a blues song using those lyrics with a slow saxophone solo."
3. "Create a 3-minute cinematic orchestral instrumental track that sounds like a space adventure theme."

Tips & Limitations

• Efficiency: Always use the --wait flag for generation commands to ensure the agent holds the process until the audio URL is retrieved. Without it, the agent may not be able to return the file path immediately.
• Credits: Keep in mind that Suno operations consume account credits. Monitor your balance using the scripts/suno.sh credits command.
• Authentication: If you encounter API errors, your Suno session cookie likely expired. Follow the manual refresh steps via browser DevTools to update your .env file.
• Workflow: Use the lyrics command first for complex requests. It allows you to refine the creative output before spending credits on final song production.