Providers
ComfyUI
OpenClaw には、ワークフロー駆動の ComfyUI 実行向けに、comfy プラグインが同梱されています。このプラグインは完全にワークフロー駆動であるため、OpenClaw は汎用的な size、aspectRatio、resolution、durationSeconds、または TTS 形式のコントロールをグラフにマッピングしようとはしません。
| プロパティ | 詳細 |
|---|---|
| Provider | comfy |
| Models | 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ツールによる音楽または音声生成 - 設定済みノード、または一致するすべての出力ノードからの出力ダウンロード
はじめに
自分のマシンで ComfyUI を実行するか、Comfy Cloud を使うかを選択します。
Local
最適な用途: 自分のマシンまたは LAN 上で自身の ComfyUI インスタンスを実行する場合。
ComfyUI をローカルで起動する
ローカルの ComfyUI インスタンスが実行中であることを確認してください（デフォルトは http://127.0.0.1:8188）。
ワークフロー JSON を準備する
ComfyUI のワークフロー JSON ファイルをエクスポートまたは作成します。プロンプト入力ノードと、OpenClaw が読み取る出力ノードのノード ID を控えておいてください。
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", }, }, }, }, },}デフォルトモデルを設定する
設定した機能の comfy/workflow モデルを OpenClaw に指定します。
{ agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, },}検証する
openclaw models list --provider comfyComfy Cloud
最適な用途: ローカル GPU リソースを管理せずに Comfy Cloud 上でワークフローを実行する場合。
API キーを取得する
comfy.org で登録し、アカウントダッシュボードから API キーを生成します。
API キーを設定する
次のいずれかの方法でキーを指定します。
# 環境変数（推奨）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 を控えておいてください。
Provider を設定する
mode: "cloud" を設定し、ワークフローファイルを指定します。
{ plugins: { entries: { comfy: { config: { mode: "cloud", image: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, }, }, }, },}デフォルトモデルを設定する
{ 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" or "cloud" |
接続モード。 |
baseUrl |
string | local ではデフォルトで http://127.0.0.1:8188、cloud では https://cloud.comfy.org。 |
apiKey |
string | 任意のインラインキー。COMFY_API_KEY / COMFY_CLOUD_API_KEY 環境変数の代替です。 |
allowPrivateNetwork |
boolean | cloud モードでプライベート / LAN の baseUrl を許可します。 |
機能ごとのキー
これらのキーは image、video、または music セクション内で適用されます。
| キー | 必須 | デフォルト | 説明 |
|---|---|---|---|
workflow or workflowPath |
Yes | -- | ComfyUI ワークフロー JSON ファイルへのパス。 |
promptNodeId |
Yes | -- | テキストプロンプトを受け取るノード ID。 |
promptInputName |
No | "text" |
プロンプトノード上の入力名。 |
outputNodeId |
No | -- | 出力を読み取るノード ID。省略した場合、一致するすべての出力ノードが使われます。 |
pollIntervalMs |
No | -- | ジョブ完了を確認するためのポーリング間隔（ミリ秒）。 |
timeoutMs |
No | -- | ワークフロー実行のタイムアウト（ミリ秒）。 |
image および video セクションでは、以下もサポートされます。
| キー | 必須 | デフォルト | 説明 |
|---|---|---|---|
inputImageNodeId |
Yes (when passing a reference image) | -- | アップロードした参照画像を受け取るノード ID。 |
inputImageInputName |
No | "image" |
画像ノード上の入力名。 |
ワークフローの詳細
Image workflows
デフォルトの画像モデルを 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", }, }, }, }, },}Video workflows
デフォルトの動画モデルを comfy/workflow に設定します。
{ agents: { defaults: { videoGenerationModel: { primary: "comfy/workflow", }, }, },}Comfy の動画ワークフローは、設定されたグラフを通じて text-to-video と image-to-video をサポートします。
Music workflows
同梱プラグインは、ワークフローで定義された音声または音楽出力向けの音楽生成 Provider を登録し、共有 music_generate ツールを通じて公開します。
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"music 設定セクションを使って、音声ワークフロー JSON と出力ノードを指定します。
Backward compatibility
既存のトップレベル画像設定（ネストされた image セクションなし）も引き続き動作します。
{ plugins: { entries: { comfy: { config: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, }, }, },}OpenClaw はこのレガシー形式を画像ワークフロー設定として扱います。すぐに移行する必要はありませんが、新しいセットアップではネストされた image / video / music セクションを推奨します。
ライブテスト
同梱プラグインにはオプトインのライブカバレッジがあります。
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts対応する Comfy ワークフローセクションが設定されていない限り、ライブテストは個々の画像、動画、または音楽のケースをスキップします。