Tạo nhạc

​

Bắt đầu nhanh

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

/tool music_generate prompt="Warm ambient synth loop with soft tape texture"

Generate a cinematic piano track with soft strings and no vocals.

Generate an energetic chiptune loop about launching a rocket at sunrise.

​

Nhà cung cấp được hỗ trợ

​

Ma trận khả năng

/tool music_generate action=list

/tool music_generate action=status

/tool music_generate prompt="Dreamy lo-fi hip hop with vinyl texture and gentle rain" instrumental=true

​

Tham số công cụ

​

Hành vi bất đồng bộ

• Tác vụ nền: music_generate tạo một tác vụ nền, trả về phản hồi đã bắt đầu/tác vụ ngay lập tức, và đăng bản nhạc hoàn tất sau trong một tin nhắn agent tiếp theo.
• Ngăn trùng lặp: khi một tác vụ đang queued hoặc running, các lệnh gọi music_generate sau đó trong cùng phiên sẽ trả về trạng thái tác vụ thay vì bắt đầu một lần tạo khác. Dùng action: "status" để kiểm tra rõ ràng.
• Tra cứu trạng thái: openclaw tasks list hoặc openclaw tasks show <taskId> kiểm tra trạng thái đang xếp hàng, đang chạy và trạng thái kết thúc.
• Đánh thức hoàn tất: OpenClaw tiêm một sự kiện hoàn tất nội bộ trở lại cùng phiên để mô hình có thể tự viết phản hồi tiếp theo hướng tới người dùng.
• Gợi ý prompt: các lượt người dùng/thủ công sau trong cùng phiên nhận một gợi ý runtime nhỏ khi đã có tác vụ nhạc đang chạy, để mô hình không gọi lại music_generate một cách mù quáng.
• Dự phòng không có phiên: các ngữ cảnh trực tiếp/cục bộ không có phiên agent thật sẽ chạy nội tuyến và trả về kết quả âm thanh cuối trong cùng lượt.

​

Vòng đời tác vụ

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

​

Cấu hình

​

Chọn mô hình

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

​

Thứ tự chọn nhà cung cấp

1. Tham số model từ lệnh gọi công cụ (nếu agent chỉ định).
2. musicGenerationModel.primary từ cấu hình.
3. musicGenerationModel.fallbacks theo thứ tự.
4. Tự động phát hiện chỉ bằng các mặc định nhà cung cấp có xác thực:
   • nhà cung cấp mặc định hiện tại trước;
   • các nhà cung cấp tạo nhạc đã đăng ký còn lại theo thứ tự provider-id.

​

Ghi chú về nhà cung cấp

​

Chọn đường dẫn phù hợp

• Dựa trên nhà cung cấp dùng chung khi bạn muốn chọn mô hình, chuyển đổi dự phòng nhà cung cấp và luồng tác vụ/trạng thái bất đồng bộ tích hợp sẵn.
• Đường dẫn Plugin (ComfyUI) khi bạn cần đồ thị quy trình làm việc tùy chỉnh hoặc một nhà cung cấp không thuộc khả năng nhạc dùng chung đi kèm.

​

Chế độ năng lực của nhà cung cấp

• generate để tạo chỉ từ prompt.
• edit khi yêu cầu bao gồm một hoặc nhiều ảnh tham chiếu.

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

​

Kiểm thử live

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

pnpm test:live:media music

• google: generate cộng với edit
• fal: chỉ generate
• minimax: chỉ generate
• openrouter: generate cộng với edit
• comfy: phạm vi live Comfy riêng, không thuộc lượt quét nhà cung cấp dùng chung

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

​

Liên quan

• Tác vụ nền — theo dõi tác vụ cho các lần chạy music_generate tách rời
• ComfyUI
• Tham chiếu cấu hình — cấu hình musicGenerationModel
• Google (Gemini)
• MiniMax
• Mô hình — cấu hình mô hình và chuyển đổi dự phòng
• Tổng quan công cụ