audio-song-generate

name	audio-song-generate
description	歌词驱动的完整歌曲生成（含人声），也支持强节奏成品级纯音乐。仅当用户明确要求生成歌曲/音频成品，并提供或同意补充风格与歌词参数时触发；普通音乐讨论、歌词创作、闲聊式演唱请求不触发。
version	1.0.0
metadata	{"openclaw":{"requires":{"bins":["meitu"],"env":["MEITU_OPENAPI_ACCESS_KEY","MEITU_OPENAPI_SECRET_KEY","MEITU_OPENAPI_TOOL_TASK_MODE"],"paths":{"read":["~/.meitu/credentials.json","~/.meitu/tool-registry.json","~/.openclaw/workspace/visual/","./openclaw.yaml"],"write":["~/.openclaw/workspace/visual/","./output/"]}},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY","security":{"dataFlow":"Inputs, selected local context, and generated prompts may be sent to Meitu OpenAPI when used by the workflow.","credentials":"Credentials are used only for CLI authentication and must not be disclosed."}}}
security	{"credential_use":"Uses Meitu OpenAPI credentials from env or ~/.meitu/credentials.json for CLI calls; credentials must not be echoed, logged, or embedded in prompts.","remote_processing":"Song style prompts and lyrics are sent to Meitu OpenAPI for audio generation.","persistence":"Generated MP3 files are written to the resolved output directory."}
requirements	{"credentials":[{"name":"MEITU_OPENAPI_ACCESS_KEY","source":"env | ~/.meitu/credentials.json"},{"name":"MEITU_OPENAPI_SECRET_KEY","source":"env | ~/.meitu/credentials.json"}],"env":{"MEITU_OPENAPI_TOOL_TASK_MODE":"command"},"permissions":[{"type":"file_read","paths":["~/.meitu/credentials.json","~/.meitu/tool-registry.json","~/.openclaw/workspace/visual/","./openclaw.yaml"]},{"type":"file_write","paths":["~/.openclaw/workspace/visual/","./output/"]},{"type":"exec","commands":["meitu"]}]}

Audio Song Generate

Overview

歌词驱动的完整歌曲生成（含人声，主歌/桥段/合唱完整结构），多风格创作（流行/古风/电子/摇滚等）。也支持强节奏 / 完整编曲感的纯音乐，编曲能力优于通用纯音乐工具。

API Mapping

• 歌曲与强节奏纯音乐生成：audio_cashew_songgenerate

Dependencies

• meitu-cli: >=2.0.6
• 凭证：CONFIG AKSK → meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）
• 环境变量：MEITU_OPENAPI_TOOL_TASK_MODE=command

路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/

Core Workflow

Preflight → Execute → Deliver

Preflight

1. meitu --version ≥ 2.0.6
2. 已用 CONFIG AKSK 跑过 meitu tools update
3. 当前 AKSK = EXEC，MEITU_OPENAPI_TOOL_TASK_MODE=command
4. output_dir：openclaw.yaml → ./output/ ｜else → $VISUAL/output/audio-song-generate/；mkdir -p

Execute

触发信号 / 路由规则

核心维度：人声/编曲场景命中 + 参数齐全。

场景	判定关键词	路由
含人声的完整歌曲	写首歌、带人声、带歌词、唱一首、品牌歌曲	audio_cashew_songgenerate
强节奏 / 完整编曲的纯音乐	强节奏、强变化、反转旋律、完整编曲感	audio_cashew_songgenerate

单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。风格与歌词矛盾时以 prompt（风格）为准。

参数定义

参数	类型	必填	范围	默认	说明
prompt	STRING	是	--	--	歌曲风格描述。缺失 → 提示"请描述你想要的歌曲风格"
prompt_lyrics	STRING	是	--	--	歌词内容。缺失 → 提示"请提供歌词内容"（强节奏纯音乐场景可填空字符串或风格化描述）
model	STRING	否	auto / mureka-6 / mureka-7.5 / mureka-o1	auto	生成模型选择，非法值回退 auto

audio_cashew_songgenerate 使用 prompt + prompt_lyrics + model。人声质量受多语言发音影响。

工具调用

meitu audio-song-generate --prompt "<style>" --prompt_lyrics "<lyrics>" [--model auto] --json --download-dir {output_dir} --skill_name skill_audio-song-generate

错误降级

场景	处理方式
prompt 缺失	提示"请描述你想要的歌曲风格"，不调用 API
prompt_lyrics 缺失（含人声场景）	提示"请提供歌词内容"，不调用 API
model 指定了不存在的值	回退 auto
audio_cashew_songgenerate 调用失败	重试 1 次，仍失败返回错误
prompt 与 prompt_lyrics 风格矛盾	以 prompt 为准，告知用户歌词将按指定风格编曲
用户只要歌词不要旋律	拒绝，不属于本工具范围
内容合规拦截	直接返回合规提示，不重试

Deliver

• 使用 Preflight 解析的 output_dir
• 从 downloaded_files[0].saved_path 读取已下载音频文件路径
• mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_audio-song-generate.mp3

Output

• 格式：MP3
• 位置：项目 → ./output/，一次性 → $VISUAL/output/audio-song-generate/

基线 Task ID

见 references/task-id-baseline.md 中对应行。