ComfyUI

OpenClaw には、ワークフロー駆動の ComfyUI 実行用 comfy Plugin がバンドルされています。この Plugin は完全にワークフロー駆動です。OpenClaw は、汎用の size、 aspectRatio、resolution、durationSeconds、または TTS 形式のコントロールをグラフにマッピングしません。

プロパティ	詳細
プロバイダー	`comfy`
モデル	`comfy/workflow`
共有ツール	`image_generate`、`video_generate`、`music_generate`
認証	ローカル ComfyUI では不要。Comfy Cloud では `COMFY_API_KEY` または `COMFY_CLOUD_API_KEY`
API	ComfyUI `/prompt` / `/history` / `/view`、Comfy Cloud `/api/*`

サポートされる機能

ワークフロー JSON による画像生成と編集（編集ではアップロードされた参照画像を 1 枚使用）
ワークフロー JSON による動画生成、テキストから動画または画像から動画（参照画像 1 枚）
共有 music_generate ツールによる音楽／音声生成（参照画像 1 枚を任意で使用可能）
設定されたノードからの出力ダウンロード。ノードが設定されていない場合は、一致するすべての出力ノードからダウンロード

はじめに

自分のマシンで ComfyUI を実行するか、Comfy Cloud を使用するかを選択します。

ローカル
Comfy Cloud

最適な用途: 自分のマシンまたは LAN 上で独自の ComfyUI インスタンスを実行する場合。

ComfyUI をローカルで起動する

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

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

ComfyUI ワークフロー JSON ファイルをエクスポートまたは作成します。プロンプト入力ノードと、OpenClaw が読み取る出力ノードのノード ID を確認します。

プロバイダーを設定する

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",
          },
        },
      },
    },
  },
}

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

設定した機能の comfy/workflow モデルを OpenClaw に指定します。

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}

確認する

openclaw models list --provider comfy

最適な用途: ローカル GPU リソースを管理せずに Comfy Cloud でワークフローを実行する場合。

API キーを取得する

comfy.org で登録し、アカウントダッシュボードから API キーを生成します。

API キーを設定する

次のいずれかの方法でキーを指定します。

# オンボーディングフラグ
openclaw onboard --comfy-api-key "your-key"

# 環境変数（デーモンに推奨）
export COMFY_API_KEY="your-key"

# 代替の環境変数
export COMFY_CLOUD_API_KEY="your-key"

# または設定内で直接指定
openclaw config set plugins.entries.comfy.config.apiKey "your-key"

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

ComfyUI ワークフロー JSON ファイルをエクスポートまたは作成します。プロンプト入力ノードと出力ノードのノード ID を確認します。

プロバイダーを設定する

mode: "cloud" を設定し、ワークフローファイルを指定します。

{
  plugins: {
    entries: {
      comfy: {
        config: {
          mode: "cloud",
          image: {
            workflowPath: "./workflows/flux-api.json",
            promptNodeId: "6",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}

クラウドモードでは、baseUrl のデフォルトは https://cloud.comfy.org です。カスタムクラウドエンドポイントを使用する場合にのみ baseUrl を設定してください。

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

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}

確認する

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"`。
`baseUrl`	文字列	ローカルではデフォルトが `http://127.0.0.1:8188`、クラウドでは `https://cloud.comfy.org`。
`apiKey`	文字列	任意のインラインキー。環境変数 `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY` の代替。
`allowPrivateNetwork`	真偽値	クラウドモードでプライベート／LAN の `baseUrl`、またはローカルのプライベート DNS FQDN を許可します。

local モードでは、ループバック／プライベート IP リテラルと、http://comfyui:8188 のような単一ラベルのサービス名は、allowPrivateNetwork なしで動作します。https://comfy.local.example.com のように公開アドレスに見えるプライベート DNS FQDN には、allowPrivateNetwork: true が必要です。プライベートオリジンへの信頼は、設定されたスキーム、ホスト名、ポートに限定されます。ローカルリダイレクトは設定されたホスト名の外部へ移動できません。一方、公開 CDN へのクラウドリダイレクトは、デフォルトの SSRF ポリシーで検査されます。

機能ごとのキー

これらのキーは、image、video、または music セクション内に適用されます。

キー	必須	デフォルト	説明
`workflow` または `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 の動画ワークフローは、設定されたグラフを通じてテキストから動画、および画像から動画をサポートします。

OpenClaw は入力動画を Comfy ワークフローに渡しません。入力としてサポートされるのは、テキストプロンプトと 1 枚の参照画像のみです。

音楽ワークフロー

バンドルされた Plugin は、ワークフローで定義された音声または音楽出力用の音楽生成プロバイダーを登録し、共有 music_generate ツールを通じて提供します。任意の参照画像を受け付けます（最大 1 枚）。

/tool music_generate prompt="柔らかなテープの質感を持つ温かいアンビエントシンセループ"

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 ワークフローセクションが設定されていない場合、ライブテストでは個別の画像、動画、音楽のケースがスキップされます。

画像生成

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

動画生成

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

音楽生成

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

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

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

設定リファレンス

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

Overview

Concepts and configuration

Providers

サポートされる機能

はじめに

設定

共有キー

機能ごとのキー

ワークフローの詳細

関連項目

画像生成

動画生成

音楽生成

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

設定リファレンス

​サポートされる機能

​はじめに

​設定

​共有キー

​機能ごとのキー

​ワークフローの詳細

​関連項目

画像生成

動画生成

音楽生成

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

設定リファレンス

サポートされる機能

はじめに

設定

共有キー

機能ごとのキー

ワークフローの詳細

関連項目