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 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 chỉnh 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ần 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 chờ, đang chạy và trạng thái kết thúc.
• Đánh thức khi hoàn tất: OpenClaw đưa 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 nối 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 ý nhỏ ở thời gian chạy khi đã có tác vụ nhạc đang diễn ra, để mô hình không mù quáng gọi lại music_generate.
• 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 cùng 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 đã đăng ký còn lại theo thứ tự id nhà cung cấp.

​

Ghi chú về nhà cung cấp

​

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

• Có nhà cung cấp dùng chung hỗ trợ 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 một đồ 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 tạo nhạc dùng chung đi kèm.

​

Chế độ khả năng của nhà cung cấp

• generate cho tạo chỉ bằng prompt.
• edit khi yêu cầu bao gồm một hoặc nhiều hình ả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 trực tiếp Comfy riêng, không thuộc đợ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ượt 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ụ