メインコンテンツへスキップ

​
ComfyUI

OpenClaw には、ワークフロー駆動の ComfyUI 実行に対応する、バンドルされた comfy Plugin が含まれています。この Plugin は完全にワークフロー駆動のため、OpenClaw は汎用的な size、aspectRatio、resolution、durationSeconds、または TTS 風の制御をグラフへマッピングしようとはしません。
PropertyDetail
プロバイダーcomfy
モデルcomfy/workflow
共通サーフェスimage_generate, video_generate, music_generate
認証ローカル ComfyUI では不要、Comfy Cloud では COMFY_API_KEY または COMFY_CLOUD_API_KEY
APIComfyUI /prompt / /history / /view および Comfy Cloud /api/*

​
サポート内容

  • ワークフロー JSON からの画像生成
  • アップロードされた参照画像 1 枚を使った画像編集
  • ワークフロー JSON からの動画生成
  • アップロードされた参照画像 1 枚を使った動画生成
  • 共通の music_generate ツールによる音楽または音声生成
  • 設定済みノード、または一致するすべての出力ノードからの出力ダウンロード

​
はじめに

自分のマシンで ComfyUI を実行するか、Comfy Cloud を使うかを選んでください。
最適な用途: 自分のマシンまたは LAN 上で ComfyUI インスタンスを実行する場合。
1

ComfyUI をローカルで起動する

ローカルの ComfyUI インスタンスが起動していることを確認してください（デフォルトは http://127.0.0.1:8188）。
2

ワークフロー JSON を準備する

ComfyUI ワークフロー JSON ファイルをエクスポートするか作成します。プロンプト入力ノードと、OpenClaw が読み取る出力ノードのノード ID を控えてください。
3

プロバイダーを設定する

mode: "local" を設定し、ワークフロー ファイルを指定します。以下は最小の画像例です:
{
  models: {
    providers: {
      comfy: {
        mode: "local",
        baseUrl: "http://127.0.0.1:8188",
        image: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}
4

デフォルト モデルを設定する

設定した機能用に、OpenClaw を comfy/workflow モデルへ向けます:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

確認する

openclaw models list --provider comfy

​
設定

Comfy は、共通のトップレベル接続設定と、機能ごとのワークフロー セクション（image、video、music）をサポートしています: 
{
  models: {
    providers: {
      comfy: {
        mode: "local",
        baseUrl: "http://127.0.0.1:8188",
        image: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
        video: {
          workflowPath: "./workflows/video-api.json",
          promptNodeId: "12",
          outputNodeId: "21",
        },
        music: {
          workflowPath: "./workflows/music-api.json",
          promptNodeId: "3",
          outputNodeId: "18",
        },
      },
    },
  },
}

​
共通キー

KeyTypeDescription
mode"local" または "cloud"接続モード。
baseUrlstringローカルではデフォルトで http://127.0.0.1:8188、cloud では https://cloud.comfy.org。
apiKeystringオプションのインライン キー。COMFY_API_KEY / COMFY_CLOUD_API_KEY 環境変数の代替です。
allowPrivateNetworkbooleancloud モードでプライベート/LAN の baseUrl を許可します。

​
機能ごとのキー

これらのキーは image、video、または music セクション内で適用されます:
KeyRequiredDefaultDescription
workflow または workflowPathYes—ComfyUI ワークフロー JSON ファイルへのパス。
promptNodeIdYes—テキスト プロンプトを受け取るノード ID。
promptInputNameNo"text"プロンプト ノード上の入力名。
outputNodeIdNo—出力を読み取るノード ID。省略した場合、一致するすべての出力ノードが使われます。
pollIntervalMsNo—ジョブ完了を確認するポーリング間隔（ミリ秒）。
timeoutMsNo—ワークフロー実行のタイムアウト（ミリ秒）。
image と video セクションでは、次もサポートされます:
KeyRequiredDefaultDescription
inputImageNodeId参照画像を渡す場合は Yes—アップロードされた参照画像を受け取るノード ID。
inputImageInputNameNo"image"画像ノード上の入力名。

​
ワークフローの詳細

デフォルトの画像モデルを comfy/workflow に設定します:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
参照画像編集の例:アップロードされた参照画像による画像編集を有効にするには、画像設定に inputImageNodeId を追加します:
{
  models: {
    providers: {
      comfy: {
        image: {
          workflowPath: "./workflows/edit-api.json",
          promptNodeId: "6",
          inputImageNodeId: "7",
          inputImageInputName: "image",
          outputNodeId: "9",
        },
      },
    },
  },
}
デフォルトの動画モデルを comfy/workflow に設定します:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Comfy の動画ワークフローは、設定されたグラフを通じて text-to-video と image-to-video をサポートします。
OpenClaw は入力動画を Comfy ワークフローへ渡しません。入力としてサポートされるのは、テキスト プロンプトと単一の参照画像のみです。
バンドルされた Plugin は、ワークフローで定義された音声または音楽出力用の音楽生成プロバイダーを登録し、共通の music_generate ツールを通じて公開します:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
music 設定セクションを使って、音声ワークフロー JSON と出力ノードを指定します。
既存のトップレベル画像設定（ネストされた image セクションなし）も引き続き動作します:
{
  models: {
    providers: {
      comfy: {
        workflowPath: "./workflows/flux-api.json",
        promptNodeId: "6",
        outputNodeId: "9",
      },
    },
  },
}
OpenClaw は、このレガシー形式を画像ワークフロー設定として扱います。すぐに移行する必要はありませんが、新しいセットアップではネストされた image / video / music セクションを推奨します。
画像生成だけを使う場合、レガシーのフラット設定と新しいネストされた image セクションは機能的に同等です。
バンドルされた Plugin にはオプトインのライブ カバレッジがあります:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
ライブ テストでは、一致する Comfy ワークフロー セクションが設定されていない限り、個別の画像、動画、または音楽ケースはスキップされます。

​
関連

画像生成

画像生成ツールの設定と使い方。

動画生成

動画生成ツールの設定と使い方。

音楽生成

音楽および音声生成ツールのセットアップ。

プロバイダー ディレクトリ

すべてのプロバイダーとモデル ref の概要。

設定リファレンス

エージェントのデフォルトを含む完全な設定リファレンス。