音楽生成

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.

​

クイックスタート

{
  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 は内部の完了イベントを同じセッションに 注入し、モデルがユーザー向けのフォローアップを 自分で書けるようにします。
• プロンプトヒント: 同じセッションの後続のユーザー/手動ターンでは、音楽タスクがすでに進行中の場合に小さな 実行時ヒントを受け取ります。そのため、モデルは 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. 認証に基づくプロバイダーのデフォルトのみを使用した自動検出:
   • 現在のデフォルトプロバイダーを最初に使用。
   • 残りの登録済み音楽生成プロバイダーを provider-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
• minimax: generate のみ
• comfy: 個別の Comfy ライブカバレッジ。共有プロバイダー sweep ではありません

OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts

​

関連

• バックグラウンドタスク — デタッチされた music_generate 実行のタスク追跡
• ComfyUI
• 設定リファレンス — musicGenerationModel 設定
• Google (Gemini)
• MiniMax
• モデル — モデル設定とフェイルオーバー
• ツール概要