Tạo nhạc

Documentation Index

Fetch the complete documentation index at: https://docs2.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, 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ệnh gọi music_generate sau trong cùng phiên 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 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 đã xếp hàng, đang chạy và trạng thái cuối.
• Đá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 để model có thể tự viết phần theo dõi hiển thị cho 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 tác vụ nhạc đang chạy, để model không gọi music_generate lại một cách mù quáng.
• Dự phòng không 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 model

{
  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 mặc định của 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ú nhà cung cấp

​

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

• Được hỗ trợ bởi nhà cung cấp dùng chung khi bạn muốn chọn model, chuyển 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ị workflow tùy chỉnh hoặc một nhà cung cấp không thuộc năng lực nhạc tích hợp dùng chung.

​

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

• generate cho việc tạo chỉ bằng 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
• minimax: chỉ generate
• comfy: phạm vi live Comfy riêng, không phải sweep 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ụ