A comprehensive automation skill for Suno AI that handles authentication, custom song generation, and audio file management.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install suno-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install suno-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Suno AI Music Creator?
The Suno AI Music Creator is a powerful technical integration designed to bridge the gap between AI coding agents and professional AI music production. By leveraging Playwright and persistent browser contexts, this skill enables an AI agent to navigate the Suno.com interface, manage Google OAuth sessions, and handle the intricacies of the music creation pipeline without manual user intervention.
Built to be a core part of the Openclaw Skills library, it offers a robust solution for developers looking to incorporate high-quality audio generation into their workflows. It specifically addresses common automation hurdles like hCaptcha challenges by utilizing the Gemini API for vision-based problem solving, ensuring a high success rate for automated song production.
Suno AI Music Creator Use Cases
- Automating the creation of custom soundtracks for social media content or marketing videos.
- Programmatically generating songs based on dynamically created lyrics or poems.
- Batch processing music production for large-scale creative projects.
- Managing Suno AI account credits and downloads through a CLI or AI agent interface.
How Suno AI Music Creator Works
- The skill starts with an environment check to verify dependencies like Google Chrome and Playwright are correctly installed.
- It initiates a secure login sequence using Google OAuth, utilizing a persistent browser profile to store session cookies and local storage.
- Upon receiving a music generation prompt, it navigates to the Suno creation dashboard and inputs the lyrics, style tags, and title.
- It monitors the creation process, employing a Gemini-powered hCaptcha solver if a challenge is presented during the submission.
- Once the generation is complete, the skill intercepts the internal API response to retrieve the file IDs and automatically downloads the MP3 files to a designated directory.
Suno AI Music Creator Setup
First, ensure you have Google Chrome installed on your system. Then, follow these steps to integrate this into your Openclaw Skills environment:
# Navigate to the skill directory and install dependencies
cd suno
pip3 install -r requirements.txt
playwright install
# For Linux/Cloud environments, install Xvfb for GUI simulation
sudo apt update && sudo apt install -y xvfb google-chrome-stable
# Configure your Gemini API key for CAPTCHA bypass
mkdir -p ~/.suno
echo "GEMINI_API_KEY=your_key" > ~/.suno/.env
Suno AI Music Creator Data Schema & Taxonomy
The skill organizes generated media and configuration data using the following structure:
| Component | Path / Format | Description |
|---|---|---|
| Browser Profile | ~/.suno/chrome_gui_profile |
Stores persistent session data and cookies. |
| Environment | ~/.suno/.env |
Contains the Gemini API key for CAPTCHA solving. |
| Audio Output | {baseDir}/output_mp3 |
Default directory for downloaded MP3 files. |
| Metadata | Internal API JSON | Captured clip IDs and generation status. |
Suno AI Music Creator Advanced Features
- Headless server support utilizing Xvfb virtual displays on Linux machines.
- Automated hCaptcha bypass via vision-language model integration using Gemini.
- Persistent session management to minimize the need for manual Google re-authentication.
- Dual-version capture, ensuring all variations generated by a single Suno prompt are downloaded.
- Custom hCaptcha patching for domain compatibility during automated interactions.
SKILL.md
Loading
Related Openclaw Skills
Suno Headless Music Creator
A specialized AI agent skill designed to automate Suno AI music production on headless Linux cloud servers using virtual display technology.
Presentation & Technical Content Generator
An automated system for generating professional Reveal.js slide decks and technical articles directly from source code and research papers.
Guide Creator
Guide Creator is a specialized documentation system that generates and maintains standardized project guides to ensure seamless AI context recovery and development continuity.
Red Team - Adversarial Debate Engine
An adversarial multi-agent engine that orchestrates AI personas with conflicting worldviews to stress-test decisions and strategies through structured debate.
Cloudflare
A comprehensive automation interface to manage Cloudflare DNS, security, CDN settings, and serverless Workers via API.
DigitalOcean Management Skill
A comprehensive command-line integration for programmatically managing DigitalOcean cloud infrastructure, including Droplets, DNS, and storage.
METADATA
Featured*
