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 comfy

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