Tạo nhạc

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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 năng lực

/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, rồi đă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 ở trạng thái 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ượt tạo khác. Dùng action: "status" để kiểm tra tường minh.
• 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 khi hoàn tất: OpenClaw chèn 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 tiếp theo hướng tới người dùng.
• Gợi ý lời nhắc: các lượt người dùng/thủ công sau trong cùng phiên nhận được một gợi ý nhỏ lúc chạy khi một tác vụ nhạc đang được thực hiện, để 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ực 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: ["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 còn lại đã đăng ký theo thứ tự mã định danh nhà cung cấp.

​

Ghi chú nhà cung cấp

​

Chọn hướng phù hợp

• Được hỗ trợ bởi 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.
• Đườ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 năng lực nhạc dùng chung đi kèm.

​

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

• generate để tạo chỉ bằng lời nhắc.
• 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ử trực tiếp

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
• minimax: chỉ generate
• comfy: phạm vi kiểm thử live Comfy riêng, không phải đợ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 về công cụ