音楽生成

​

クイックスタート

{
  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" を使います。最近完了した一致リクエストも2分間重複排除されます。
• ステータス参照: openclaw tasks list または openclaw tasks show <taskId> は、キュー済み、実行中、終了状態を確認します。
• 完了時の起動: OpenClaw は内部の完了イベントを同じセッションに注入し、モデルがユーザー向けの後続メッセージを自分で書けるようにします。
• プロンプトヒント: 同じセッション内の後続のユーザー/手動ターンでは、音楽タスクがすでに進行中の場合に小さなランタイムヒントを受け取るため、モデルが盲目的に再度 music_generate を呼び出すことはありません。
• セッションなしフォールバック: 実際のエージェントセッションを持たない直接/ローカルコンテキストはインラインで実行され、同じターンで最終的な音声結果を返します。

​

タスクライフサイクル

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

​

設定

​

モデル選択

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

​

プロバイダー選択順序

1. ツール呼び出しの model パラメーター（エージェントが指定した場合）。
2. 設定の musicGenerationModel.primary。
3. musicGenerationModel.fallbacks の順序。
4. 認証済みプロバイダーのデフォルトのみを使った自動検出:
   • 現在のデフォルトテキストモデルプロバイダーが音楽生成も提供している場合は、それを最初に使用します。
   • 残りの登録済み音楽生成プロバイダーを、プロバイダー ID のアルファベット順に使用します。

​

プロバイダーノート

​

適切なパスの選択

• 共有プロバイダー支援 は、モデル選択、プロバイダー フェイルオーバー、組み込みの非同期タスク/ステータスフローが必要な場合に使用します。
• Plugin パス (ComfyUI) は、カスタムワークフローグラフ、または 共有のバンドルされた音楽機能に含まれないプロバイダーが必要な場合に使用します。

​

プロバイダー機能モード

• generate はプロンプトのみの生成用です。
• edit はリクエストに 1 つ以上の参照画像が含まれる場合に使用します。

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

​

ライブテスト

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

pnpm test:live:media:music

• google: generate と edit
• fal: generate のみ
• minimax: generate のみ
• openrouter: generate と edit
• comfy: 共有プロバイダーの一括テストではなく、別個の 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
• モデル — モデル構成とフェイルオーバー
• ツール概要