SunoMaker is a professional-grade automation tool for generating AI music on headless Linux servers using virtual display technology and Gemini-powered captcha solving.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sunomaker
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 sunomaker 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 SunoMaker?
SunoMaker is a specialized automation framework designed to run Suno AI on Linux environments that lack a graphical interface. By utilizing Xvfb Virtual Display, it creates a virtual monitor in RAM, allowing a full Google Chrome instance to run in GUI mode. This technical approach is critical for bypassing Google's advanced anti-automation systems that typically block headless browsers. As a core part of the Openclaw Skills ecosystem, it provides a seamless bridge between raw lyrics and high-quality MP3 files.
The skill integrates Gemini 3.1 Pro to handle complex hCaptcha challenges automatically, ensuring that song generation workflows remain uninterrupted. It is built for developers who need to generate professional-grade music programmatically without manual intervention, making it ideal for server-side media generation pipelines.
SunoMaker Use Cases
- Automating music production on remote Linux servers and cloud VPS instances.
- Programmatic song creation using custom lyrics and specific musical style tags.
- Bypassing Google OAuth and browser-based bot detection in headless environments.
- Bulk generation and downloading of AI-composed MP3 tracks for creative projects.
How SunoMaker Works
- Environment Verification: The script runs a comprehensive check for Xvfb, Google Chrome, and required language fonts.
- Session Authentication: Users authenticate via a secure cookie import or direct Google OAuth login to establish a persistent browser context.
- Virtual Display Launch: The system initializes an Xvfb instance, simulating a 1280x800 display in memory to trick anti-bot sensors.
- Song Configuration: The skill inputs lyrics, style tags, and titles into the Suno interface via Playwright automation.
- Captcha Resolution: When challenged, the system sends hCaptcha data to Gemini 3.1 Pro for real-time automated solving.
- Generation & Polling: The tool intercepts internal API responses to monitor song progress until completion.
- Asset Retrieval: Once the tracks are ready, the skill automatically downloads the dual MP3 versions to the designated output directory.
SunoMaker Setup
First, install the core system dependencies required for Openclaw Skills to operate in a headless state:
sudo apt update && sudo apt install -y xvfb google-chrome-stable fonts-noto-cjk
Next, install the Python requirements and initialize the Playwright browser engine:
pip3 install -r requirements.txt
playwright install
Configure your environment with a Gemini API Key for automated captcha solving:
echo "GEMINI_API_KEY=your_key_here" > ~/.suno/.env
Finally, apply the hCaptcha compatibility patch to ensure the automation scripts can communicate with Suno domains:
python3 patch_hcaptcha.py
SunoMaker Data Schema & Taxonomy
SunoMaker organizes session data and generated media according to the following schema:
| Data Type | Storage Location | Description |
|---|---|---|
| Browser Profile | ~/.suno/chrome_gui_profile/ |
Maintains persistent login sessions and local storage. |
| Auth Cookies | ~/.suno/cookies.json |
Stores imported session cookies to bypass OAuth challenges. |
| Media Output | ./output_mp3/ |
The default directory where generated MP3 files are saved. |
| Environment | ~/.suno/.env |
Stores sensitive API keys and configuration variables. |
SunoMaker Advanced Features
- Xvfb Virtual Display lifecycle management for 100% headless server compatibility.
- Intelligent session persistence using Playwright's persistent browser context.
- Automated hCaptcha solving via Gemini 3.1 Pro image recognition.
- Network interception capabilities to monitor Suno's internal studio API.
- Support for advanced music style tagging and multi-language lyrics processing.
- Built-in environment health checks to ensure Chrome and display drivers are correctly configured within the Openclaw Skills framework.
SKILL.md
Loading
Related Openclaw Skills
Gemini Nano Images
Create photorealistic AI images and complete Instagram posts using Google Gemini 2.0 Flash Experimental.
Crypto Alert Agent
A proactive cryptocurrency monitoring agent that tracks market prices and portfolio values with instant Telegram notifications.
YouTube Instant Article
A specialized tool to transform any YouTube video into a visually rich, timestamped Telegraph Instant View article.
DC Weather
A streamlined utility for fetching real-time weather data for Washington, DC, directly via the Open-Meteo API without requiring API keys.
Redigg Research Agent
A specialized agent integration that connects to the Redigg platform to autonomously poll for, process, and submit scientific research tasks.
System Information Reporter
A professional diagnostic tool that generates detailed system environment reports including CPU, memory, disk, and network status in timestamped Markdown files.
METADATA
Featured*
