← 返回 Skills 市场
revolgmphl

revol-suno-headless-skill

作者 RevolGMPHL · GitHub ↗ · v1.0.6
cross-platform ⚠ suspicious
919
总下载
2
收藏
0
当前安装
7
版本数
在 OpenClaw 中安装
/install suno-headless-skill
功能描述
Suno AI 音乐创作助手(无头 Linux 服务器专用版)— 自动登录、创建歌曲、下载音频。通过 Xvfb 虚拟显示在无 GUI 的 Linux 云服务器上运行。当用户要求生成音乐、写歌、创作歌曲、用 Suno 生成 AI 音乐时使用。
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install suno-headless-skill
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /suno-headless-skill 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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
元数据
Slug suno-headless-skill
版本 1.0.6
许可证
累计安装 1
当前安装数 0
历史版本数 7
常见问题

revol-suno-headless-skill 是什么?

Suno AI 音乐创作助手(无头 Linux 服务器专用版)— 自动登录、创建歌曲、下载音频。通过 Xvfb 虚拟显示在无 GUI 的 Linux 云服务器上运行。当用户要求生成音乐、写歌、创作歌曲、用 Suno 生成 AI 音乐时使用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 919 次。

如何安装 revol-suno-headless-skill?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install suno-headless-skill」即可一键安装,无需额外配置。

revol-suno-headless-skill 是免费的吗?

是的,revol-suno-headless-skill 完全免费(开源免费),可自由下载、安装和使用。

revol-suno-headless-skill 支持哪些平台?

revol-suno-headless-skill 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 revol-suno-headless-skill?

由 RevolGMPHL(@revolgmphl)开发并维护,当前版本 v1.0.6。

💬 留言讨论