メインコンテンツへスキップ
OpenClaw は、ワークフロー駆動の ComfyUI 実行向けにバンドルされた comfy Plugin を同梱しています。この Plugin は完全にワークフロー駆動です。OpenClaw は汎用の size、 aspectRatio、resolution、durationSeconds、または TTS スタイルのコントロールを グラフに対応付けません。
プロパティ詳細
Providercomfy
Modelcomfy/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 からの動画生成、text-to-video または image-to-video（参照画像 1 つ）
  • 共有 music_generate ツールを通じた音楽/音声生成。任意で参照画像を 1 つ使用可能
  • 設定済みノードからの出力ダウンロード、または未設定の場合は一致するすべての出力ノードからのダウンロード

​
はじめに

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

ComfyUI をローカルで起動する

ローカルの ComfyUI インスタンスが実行中であることを確認します（デフォルトは http://127.0.0.1:8188）。
2

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

ComfyUI ワークフロー JSON ファイルをエクスポートまたは作成します。プロンプト入力ノードと、OpenClaw に読み取らせたい出力ノードのノード ID を控えておきます。
3

Provider を設定する

mode: "local" を設定し、ワークフローファイルを指定します。最小限の画像例:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          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）に対応しています: 
{
  plugins: {
    entries: {
      comfy: {
        config: {
          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",
          },
        },
      },
    },
  },
}

​
共有キー

キー型説明
mode"local" または "cloud"接続モード。デフォルトは "local"。
baseUrlstringローカルでは http://127.0.0.1:8188、クラウドでは https://cloud.comfy.org がデフォルト。
apiKeystring任意のインラインキー。COMFY_API_KEY / COMFY_CLOUD_API_KEY 環境変数の代替。
allowPrivateNetworkbooleanクラウドモードでプライベート/LAN の baseUrl を許可する。

​
機能ごとのキー

これらのキーは image、video、または music セクション内に適用されます:
キー必須デフォルト説明
workflow or workflowPathはい—インラインのワークフロー JSON、または ComfyUI ワークフロー JSON ファイルへのパス。
promptNodeIdはい—テキストプロンプトを受け取るノード ID。
promptInputNameいいえ"text"プロンプトノード上の入力名。
outputNodeIdいいえ—出力を読み取るノード ID。省略した場合、一致するすべての出力ノードが使用されます。
pollIntervalMsいいえ1500ジョブ完了を確認するポーリング間隔（ミリ秒）。
timeoutMsいいえ300000ワークフロー実行のタイムアウト（ミリ秒）。
image セクションと video セクションは、参照画像の入力ノードにも対応しています:
キー必須デフォルト説明
inputImageNodeIdはい（参照画像を渡す場合）—アップロード済み参照画像を受け取るノード ID。
inputImageInputNameいいえ"image"画像ノード上の入力名。
apiKey は、リテラル文字列または シークレット参照 オブジェクトのいずれかを受け付けます。

​
ワークフローの詳細

デフォルト画像モデルを comfy/workflow に設定します:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
参照画像編集の例:アップロード済み参照画像を使った画像編集を有効にするには、画像設定に inputImageNodeId を追加します:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          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 は、ワークフローで定義された音声または音楽出力向けの音楽生成 Provider を登録し、共有 music_generate ツールを通じて公開します。任意の参照画像（最大 1 つ）を受け付けます:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
music 設定セクションを使用して、音声ワークフロー JSON と出力ノードを指定します。
ネストされた image セクションを使わない既存のトップレベル画像設定も引き続き機能します:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          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 ワークフローセクションが設定されていない限り、個別の画像、動画、または音楽ケースをスキップします。

​
関連

画像生成

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

動画生成

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

音楽生成

音楽と音声生成ツールのセットアップ。

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

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

設定リファレンス

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