Генерування музики

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.

​

Швидкий старт

{
  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.

​

Підтримувані провайдери

​

Матриця можливостей

/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

​

Параметри інструмента

​

Асинхронна поведінка

• Фонове завдання: music_generate створює фонове завдання, негайно повертає відповідь про запуск/завдання, а пізніше публікує готовий трек у подальшому повідомленні агента.
• Запобігання дублюванню: доки завдання має стан queued або running, подальші виклики music_generate у тому самому сеансі повертають статус завдання замість запуску ще однієї генерації. Використовуйте action: "status" для явної перевірки.
• Перегляд статусу: openclaw tasks list або openclaw tasks show <taskId> переглядає статуси в черзі, виконання та кінцеві статуси.
• Пробудження після завершення: OpenClaw впроваджує внутрішню подію завершення назад у той самий сеанс, щоб модель могла сама написати видиме користувачу подальше повідомлення.
• Підказка промпта: наступні користувацькі/ручні ходи в тому самому сеансі отримують невелику runtime-підказку, коли завдання генерації музики вже виконується, щоб модель не викликала music_generate наосліп знову.
• Резервний шлях без сеансу: прямі/локальні контексти без справжнього сеансу агента виконуються вбудовано й повертають фінальний аудіорезультат у тому ж ході.

​

Життєвий цикл завдання

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

​

Конфігурація

​

Вибір моделі

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

​

Порядок вибору провайдера

1. Параметр model з виклику інструмента (якщо агент його вказує).
2. musicGenerationModel.primary з конфігурації.
3. musicGenerationModel.fallbacks за порядком.
4. Автовиявлення лише за стандартними провайдерами з налаштованою автентифікацією:
   • спочатку поточний стандартний провайдер;
   • решта зареєстрованих провайдерів генерації музики в порядку ідентифікаторів провайдерів.

​

Примітки щодо провайдерів

​

Вибір правильного шляху

• Спільний із підтримкою провайдерів, коли потрібні вибір моделі, резервне перемикання провайдерів і вбудований асинхронний потік завдань/статусу.
• Шлях Plugin (ComfyUI), коли потрібен власний граф робочого процесу або провайдер, який не є частиною спільної вбудованої можливості генерації музики.

​

Режими можливостей провайдера

• generate для генерації лише за промптом.
• edit, коли запит містить одне або кілька референсних зображень.

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

​

Live-тести

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

pnpm test:live:media music

• google: generate плюс edit
• minimax: лише generate
• comfy: окреме live-покриття 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
• Моделі — конфігурація моделей і аварійне перемикання
• Огляд інструментів