Producer 音乐生成

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install producer
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 producer。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Producer 音乐生成将 OpenClaw 连接到 AceDataCloud 的 Producer API，可根据文本提示或自定义歌词创作 AI 生成的音乐。可从多种 FUZZ 模型中选择，并配置人声或纯音乐输出、创意随机性、声音强度和歌词贴合度。
除了创作新歌，此技能还支持翻唱、变体、扩展、段落替换、人声与伴奏互换、分轨、歌词生成、参考音频上传，以及单独获取 WAV 或视频。其异步工作流使用任务 ID 和状态轮询，让你可以跟踪生成进度直至完成。

应用场景

根据曲风、情绪、乐器配置或其他文本提示创作歌曲。
使用带有
[Verse]
[Chorus]
等标签的结构化自定义歌词生成曲目。
为视频、游戏、演示文稿或其他项目制作纯音乐。
上传参考音频，并在支持的翻唱或扩展工作流中使用其音频 ID。
从指定时间戳继续歌曲，或重新生成选定的时间范围。
创建变体、互换人声或伴奏，或将曲目拆分为分轨。
单独生成歌词，并在音乐生成后获取 WAV 或视频输出。

工作原理

使用存储为 ACEDATACLOUD_API_TOKEN 的 AceDataCloud 服务 API 密钥进行身份验证。
向 POST /producer/audios 提交请求，并提供操作、提示词、歌词字段以及模型、标题或纯音乐模式等相关选项。
编辑现有内容时，提供现有的 audio_id 和特定操作所需的详细信息，例如 continue_at 或替换的起止时间。
获取任务 ID 后，每隔 3–5 秒使用该 ID 轮询 POST /producer/tasks；不要仅为检查进度而再次提交生成请求。
持续轮询，直到任务报告 state: "complete" 且 success: true。任务仍在处理中时，非空的 audio_url 可能只是中间预览。
使用返回的音频元数据和 URL；如需导出 WAV 或视频，请分别调用 /producer/wav 或 /producer/videos。

配置指南

安装官方技能，并确认 ClawHub 发布者为 @acedatacloud：
clawhub install @acedatacloud/producer
登录 AceDataCloud Applications，打开 General application，并检查 Producer 访问权限、余额和当前价格。复制其 API 密钥，或通过 Manage Keys 创建单独的密钥。请使用服务 API 密钥，而不是 platform-... 管理令牌；存储时不要加上 Bearer 前缀。
如果启用了 Allowed APIs 限制，请允许 /producer/audios 和 /producer/tasks。根据计划使用的工作流，添加所需的其他路由。
在 OpenClaw Gateway 主机上，将密钥添加到 ~/ .openclaw/ .env：
ACEDATACLOUD_API_TOKEN=your_api_key_here
重启 Gateway 并开启新会话。如需直接在终端测试，请在该 shell 中设置变量：
export ACEDATACLOUD_API_TOKEN="your_api_key_here"
切勿将 API 密钥放入提示词或提交 .env 文件。运行生成请求，并持续轮询返回的任务 ID，直到任务完成。

数据架构

此技能向 AceDataCloud 端点发送 JSON 请求，并接收任务结果和媒体元数据。
数据或字段 用途
action /producer/audios 的必需操作，例如 generate、cover、extend、replace_section、swap_vocals、swap_instrumentals、variation 或 stems。
prompt、lyric 创作方向和歌词；音频请求必须包含这两个字段。编辑操作不使用某个字段时，请使用空字符串。
model 可选的 FUZZ 模型选择，包括 FUZZ-2.0 Pro、FUZZ-2.0 和旧版模型。
custom、instrumental、title 用于自定义歌词、无 vocals 输出和歌曲命名的选项。
audio_id 标识用于编辑及相关操作的现有音频或已上传音频。
continue_at、replace_section_start、replace_section_end 以秒为单位的时间控制参数，用于扩展或替换歌曲片段。
lyrics_strength、sound_strength、weirdness、seed 用于控制歌词贴合度、声音权重、创意随机性和结果可复现性的可选参数。
任务响应 包含任务状态和成功状态；持续轮询，直到任务完成且成功。
已完成媒体元数据 可能包含 id、audio_url、video_url、image_url、title、lyric、style 和 model。
其他端点包括用于生成歌词的 /producer/lyrics、用于上传参考音频的 /producer/upload，以及用于单独导出的 /producer/wav 和 /producer/videos。技能文档未指定本地生成文件目录；媒体通过 API 提供的标识符和 URL 表示。

高级特性

支持八种音乐操作：生成、翻唱、扩展、替换段落、互换人声、互换伴奏、创建变体和分离分轨。
提供多种 FUZZ 模型选择，从 FUZZ-2.0 Pro 到旧版模型。
提供歌词贴合度、声音强度、随机性和基于 seed 的可复现性等创作控制项。
支持带段落标签的自定义歌词、纯音乐生成，以及单独的歌词生成请求。
可在使用现有音频 ID 的工作流中接收上传的参考音频。
使用异步任务轮询；只有
state: "complete"
success: true
才表示任务已完成，即使此前已出现预览 URL 也不例外。
主生成任务完成后，通过单独的端点获取 WAV 和视频。
必须通过环境文件或 shell 变量管理 API 密钥；不要在提示词或源代码管理中暴露密钥。

name: producer-music description: Generate AI music with Producer via AceDataCloud API. Use when creating songs, generating lyrics, extending tracks, creating covers, swapping vocals/instrumentals, replacing song sections, or uploading reference audio. Supports custom lyrics, instrumental-only mode, and multiple creative actions. license: Apache-2.0