音楽生成

​

クイックスタート

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "google/lyria-3-clip-preview",
      },
    },
  },
}

/tool music_generate prompt="柔らかなテープの質感を伴う温かみのあるアンビエントシンセのループ"

柔らかなストリングスを伴い、ボーカルのない映画的なピアノトラックを生成してください。

日の出にロケットを打ち上げることをテーマにした、エネルギッシュなチップチューンのループを生成してください。

/tool music_generate action=list
/tool music_generate action=status

/tool music_generate prompt="ビニールの質感と穏やかな雨音を伴う、夢のようなローファイ・ヒップホップ" 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。
• リクエストに1つ以上の参照画像が含まれる場合は edit。

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
• モデル — モデルの設定とフェイルオーバー
• ツールの概要