← Back to Skills Marketplace
revolgmphl

revol-suno-headless-skill

by RevolGMPHL · GitHub ↗ · v1.0.6
cross-platform ⚠ suspicious
919
Downloads
2
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install suno-headless-skill
Description
Suno AI 音乐创作助手(无头 Linux 服务器专用版)— 自动登录、创建歌曲、下载音频。通过 Xvfb 虚拟显示在无 GUI 的 Linux 云服务器上运行。当用户要求生成音乐、写歌、创作歌曲、用 Suno 生成 AI 音乐时使用。
Usage Guidance
What to consider before installing/use 1) Credentials: Never hand your primary Google/Gmail password or upload full browser cookies for your real account to an untrusted server. The export tool produces a 'full' cookie file that can include Google session tokens — importing it on a server can give that server access to other Google services. If you must use this skill, prefer the 'slim' cookie export (only Suno-related cookies) or use a throwaway Google account. 2) Avoid sending passwords to servers: The skill allows two login modes. Do NOT provide your Gmail password to the server unless you fully trust and audited the code; use local export/import of cookies performed on your desktop instead, and verify the exported cookie file contains only what you expect. 3) GEMINI_API_KEY and undeclared secrets: The skill requires a Gemini API key for hCaptcha solving but the registry metadata doesn't declare this. Treat that key as sensitive — store it only in an isolated environment and consider restricting or revoking it after use. 4) Code modifies installed packages: patch_hcaptcha.py edits the installed hcaptcha_challenger package in place. This is intrusive and can persist changes across environments. Inspect that patch file and the target package before running; consider running in an ephemeral VM or container. 5) Persistence and cleanup: The skill writes persistent data to ~/.suno (cookies, profile, logs). After use, delete ~/.suno and revoke any active sessions in your Google account. If you imported cookies, rotate/revoke the session and consider a password reset. 6) Safer alternatives: Run the entire workflow inside an isolated VM/container you control, use a disposable Google account, or run export_cookies.py locally and manually prune the cookie file to include only exact Suno domains before uploading. 7) What would reduce risk: explicit registry declaration of required env vars (GEMINI_API_KEY), a documented option to only export/import Suno domain cookies (and tooling to verify), avoiding in-place patching of site-packages (or shipping a forked library), and a clear statement about which files are persisted and where. If the author provides a minimized cookie-only import (Sun o-only cookies) and avoids modifying third-party packages, my concern level would drop. If you are not comfortable with these risks, do not install/run this skill on systems containing your real accounts or sensitive data.
Capability Analysis
Type: OpenClaw Skill Name: suno-headless-skill Version: 1.0.6 The skill is classified as suspicious due to several risky practices and vulnerabilities, despite its stated purpose appearing benign. Key indicators include: 1) The `suno_login.py` script passes Gmail credentials directly as command-line arguments, which are visible in process lists (`ps aux`), posing a credential exposure vulnerability. 2) The `patch_hcaptcha.py` script directly modifies the source code of a third-party Python library (`hcaptcha-challenger`), which is an unconventional and fragile practice that can compromise system integrity and stability. 3) The use of `sudo` for installing system dependencies and the `--no-sandbox` flag for Chrome in `suno_create_song.py` and `suno_login.py` introduce elevated privileges and reduced browser security, respectively. While these actions are intended to enable the skill's functionality (automating Suno AI on a headless server), they represent significant security risks without clear malicious intent.
Capability Assessment
Purpose & Capability
Declared purpose: headless Suno login and music generation. Required binaries (google-chrome, Xvfb) match that purpose. However the skill's runtime requirements are inconsistent with registry metadata: SKILL.md and code require a GEMINI_API_KEY for hCaptcha solving and ask for user Gmail credentials or full browser cookies, but the registry lists no required env vars/credentials. Asking for Google account cookies and passwords is not reflected in the declared metadata and is broader than the simple 'music generation' description suggests.
Instruction Scope
Runtime instructions and code direct the user to export/upload full browser cookies (the export tool saves a 'full' cookie file that can include Google session tokens) and to optionally provide Gmail email/password. The README explicitly recommends uploading the full exported cookie file to the server and then importing it into a persistent Chrome profile. The code also saves cookies and a persistent profile under ~/.suno, and runs a script that mutates an installed third‑party package (patch_hcaptcha.py). These actions go beyond 'call Suno API' style behaviour and entail storing and reusing credentials and modifying system package files.
Install Mechanism
No external arbitrary-download install spec in the registry; skill is instruction/code only. The scripts install system packages (xvfb, google-chrome via Google's APT repo) and Python packages (playwright, hcaptcha-challenger) — expected for a Playwright-based browser automation tool. However patch_hcaptcha.py directly rewrites the installed hcaptcha_challenger module file in site-packages, which is intrusive (modifies third‑party package code on disk) and increases risk if the patch is incorrect or malicious.
Credentials
The skill asks the user to supply highly sensitive items (Gmail password or full browser cookies) and to store a GEMINI_API_KEY, but the registry metadata did not declare any required env vars or primary credential. The SKILL.md text claims passwords 'will not be stored or transmitted', yet the code persists cookies to ~/.suno/cookies.json and stores a persistent Chrome profile at ~/.suno/chrome_gui_profile — contradicting that claim. Exporting/importing 'full' cookies may include Google auth tokens that grant access beyond Suno, which is disproportionate to the stated task.
Persistence & Privilege
The skill creates and uses persistent artifacts in the user's home directory (~/.suno), including saved cookies and a persistent Chrome profile. 'always' is false and the skill does not attempt to modify other skills or agent-wide settings, but the local persistence (cookies/profile) gives long-term access to the authenticated session and should be considered a privilege.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install suno-headless-skill
  3. After installation, invoke the skill by name or use /suno-headless-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
sun o-headless-skill 1.0.6 - Added `output_manager.py` file. - Enhanced documentation: login脚本支持自动检测默认 cookie 路径并自动导入,无需显式参数;全部命令行支持`--verbose`参数选择实时日志输出。
v1.0.5
suno-headless-skill 1.0.5 - 修复lyric的bug
v1.0.4
- 默认的 Cookie 文件上传路径已规范为 /root/suno_cookie/suno_cookies.json,导入登录时无需手动指定路径。 - 调整了 Cookie 登录流程的文档说明,强化上传路径的唯一性和自动读取体验。 - 其他说明与功能保持不变。
v1.0.3
- 新增本地浏览器 Cookie 导出与导入登录支持(export_cookies.py),大幅提升在云服务器上的登录成功率。 - 登录流程更新:推荐使用 Cookie 导入模式,降低 Google 安全验证失败风险。 - 文档详细说明本地导出、上传 Cookie 并导入服务器的完整流程。 - 文件结构与使用示例同步增加对 Cookie 登录的支持说明。
v1.0.2
- No file changes detected in this version. - Documentation (SKILL.md) remains unchanged from the previous version. - No user-facing features or fixes introduced.
v1.0.1
No changes since previous version. - No file changes detected for version 1.0.1. - Documentation and functionality remain unchanged from the previous release.
v1.0.0
suno-headless-skill
Metadata
Slug suno-headless-skill
Version 1.0.6
License
All-time Installs 1
Active Installs 0
Total Versions 7
Frequently Asked Questions

What is revol-suno-headless-skill?

Suno AI 音乐创作助手(无头 Linux 服务器专用版)— 自动登录、创建歌曲、下载音频。通过 Xvfb 虚拟显示在无 GUI 的 Linux 云服务器上运行。当用户要求生成音乐、写歌、创作歌曲、用 Suno 生成 AI 音乐时使用。 It is an AI Agent Skill for Claude Code / OpenClaw, with 919 downloads so far.

How do I install revol-suno-headless-skill?

Run "/install suno-headless-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is revol-suno-headless-skill free?

Yes, revol-suno-headless-skill is completely free (open-source). You can download, install and use it at no cost.

Which platforms does revol-suno-headless-skill support?

revol-suno-headless-skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created revol-suno-headless-skill?

It is built and maintained by RevolGMPHL (@revolgmphl); the current version is v1.0.6.

💬 Comments