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

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.

OpenClaw には、ワークフロー駆動の ComfyUI 実行向けに、comfy プラグインが同梱されています。このプラグインは完全にワークフロー駆動であるため、OpenClaw は汎用的な size、aspectRatio、resolution、durationSeconds、または TTS 形式のコントロールをグラフにマッピングしようとはしません。
プロパティ詳細
Providercomfy
Modelscomfy/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

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

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

設定した機能の comfy/workflow モデルを OpenClaw に指定します。
{
  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" or "cloud"接続モード。
baseUrlstringlocal ではデフォルトで 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 セクション内で適用されます。
キー必須デフォルト説明
workflow or workflowPathYes—ComfyUI ワークフロー JSON ファイルへのパス。
promptNodeIdYes—テキストプロンプトを受け取るノード ID。
promptInputNameNo"text"プロンプトノード上の入力名。
outputNodeIdNo—出力を読み取るノード ID。省略した場合、一致するすべての出力ノードが使われます。
pollIntervalMsNo—ジョブ完了を確認するためのポーリング間隔（ミリ秒）。
timeoutMsNo—ワークフロー実行のタイムアウト（ミリ秒）。
image および video セクションでは、以下もサポートされます。
キー必須デフォルト説明
inputImageNodeIdYes (when passing a reference image)—アップロードした参照画像を受け取るノード ID。
inputImageInputNameNo"image"画像ノード上の入力名。

​
ワークフローの詳細

デフォルトの画像モデルを 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 ワークフローに渡しません。入力としてサポートされるのは、テキストプロンプトと単一の参照画像のみです。
同梱プラグインは、ワークフローで定義された音声または音楽出力向けの音楽生成 Provider を登録し、共有 music_generate ツールを通じて公開します。
/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 セクションは機能的に同等です。
同梱プラグインにはオプトインのライブカバレッジがあります。
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
対応する Comfy ワークフローセクションが設定されていない限り、ライブテストは個々の画像、動画、または音楽のケースをスキップします。

​
関連

画像生成

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

動画生成

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

音楽生成

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

Provider ディレクトリ

すべての Provider とモデル参照の概要。

設定リファレンス

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