音乐生成

​

快速开始

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
      },
    },
  },
}

/tool music_generate prompt="带有柔和磁带质感的温暖氛围合成器循环"

生成一首带有柔和弦乐、无人声的电影感钢琴曲。

生成一段关于日出时发射火箭的动感芯片音乐循环。

/tool music_generate action=list
/tool music_generate action=status

/tool music_generate prompt="带有黑胶质感和柔和雨声的梦幻 lo-fi 嘻哈音乐" instrumental=true

​

支持的提供商

​

能力矩阵

​

工具参数

​

异步行为

• 后台任务：music_generate 会创建后台任务，立即返回已启动/任务响应，并稍后在智能体的后续消息中发布完成的曲目。
• **防止重复：**当任务处于 queued 或 running 状态时，同一会话中后续的 music_generate 调用会返回任务状态，而不是启动另一次生成。使用 action: "status" 进行显式检查。最近完成的相同请求也会在 2 分钟内去重。
• 状态查询：openclaw tasks list 或 openclaw tasks show <taskId> 会检查已排队、运行中和终止状态。
• **完成唤醒：**OpenClaw 会将内部完成事件注入回同一会话，使模型能够自行编写面向用户的后续消息。
• **提示词提醒：**如果音乐任务已在进行中，同一会话中后续的用户/手动轮次会收到一条简短的运行时提示，使模型不会盲目地再次调用 music_generate。
• **无会话回退：**没有真实智能体会话的直接/本地上下文会以内联方式运行，并在同一轮次中返回最终音频结果。

​

任务生命周期

openclaw tasks list
openclaw tasks show <taskId>
openclaw tasks cancel <taskId>

​

配置

​

模型选择

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
        fallbacks: ["fal/fal-ai/minimax-music/v2.6", "minimax/music-2.6"],
      },
    },
  },
}

​

提供商选择顺序

1. 工具调用中的 model 参数（如果智能体指定）。
2. 配置中的 musicGenerationModel.primary。
3. 按顺序使用 musicGenerationModel.fallbacks。
4. 仅使用由身份验证支持的提供商默认值进行自动检测：
   • 如果当前默认文本模型提供商也提供音乐生成功能，则优先使用它；
   • 其余已注册的音乐生成提供商按提供商 ID 的字母顺序排列。

​

提供商说明

​

选择正确的路径

• 如果需要模型选择、提供商故障转移以及内置的异步任务/状态流程，请选择共享提供商支持路径。
• 如果需要自定义工作流图，或使用不属于共享内置音乐能力的提供商，请选择插件路径（ComfyUI）。

​

提供商能力模式

• generate 用于仅基于提示词的生成。
• 当请求包含一张或多张参考图像时，使用 edit。

capabilities: {
  generate: {
    maxTracks: 1,
    supportsLyrics: true,
    supportsFormat: true,
  },
  edit: {
    enabled: true,
    maxTracks: 1,
    maxInputImages: 1,
    supportsFormat: true,
  },
}

​

实时测试

OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/music-generation-providers.live.test.ts

pnpm test:live:media:music

• google：generate 加 edit
• fal：仅 generate
• minimax：仅 generate
• openrouter：generate 加 edit
• comfy：单独的 Comfy 实时覆盖测试，不属于共享提供商扫描

OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts

​

相关内容

• 后台任务 — 跟踪分离式 music_generate 运行的任务
• ComfyUI
• 配置参考 — musicGenerationModel 配置
• Google (Gemini)
• MiniMax
• Models — 模型配置和故障转移
• 工具概览