ComfyUI

OpenClaw постачається з вбудованим Plugin comfy для запусків ComfyUI на основі робочих процесів. Цей Plugin повністю керується робочими процесами: OpenClaw не зіставляє загальні параметри size, aspectRatio, resolution, durationSeconds або елементи керування в стилі TTS із вашим графом.

Властивість	Відомості
Постачальник	`comfy`
Модель	`comfy/workflow`
Спільні інструменти	`image_generate`, `video_generate`, `music_generate`
Автентифікація	Не потрібна для локального ComfyUI; `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` для Comfy Cloud
API	ComfyUI `/prompt` / `/history` / `/view`; Comfy Cloud `/api/*`

Що підтримується

Генерування та редагування зображень із JSON робочого процесу (для редагування потрібне 1 завантажене еталонне зображення)
Генерування відео з JSON робочого процесу: із тексту або зображення (1 еталонне зображення)
Генерування музики й аудіо через спільний інструмент music_generate із необов’язковим 1 еталонним зображенням
Завантаження результату з налаштованого вузла або з усіх відповідних вихідних вузлів, якщо жодного не налаштовано

Початок роботи

Виберіть між запуском ComfyUI на власному комп’ютері та використанням Comfy Cloud.

Локально
Comfy Cloud

Найкраще підходить для: запуску власного екземпляра ComfyUI на вашому комп’ютері або в локальній мережі.

Запустіть ComfyUI локально

Переконайтеся, що локальний екземпляр ComfyUI працює (типова адреса — http://127.0.0.1:8188).

Підготуйте JSON робочого процесу

Експортуйте або створіть JSON-файл робочого процесу ComfyUI. Занотуйте ідентифікатори вузла введення запиту та вихідного вузла, з якого OpenClaw має зчитувати результат.

Налаштуйте постачальника

Установіть 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",
          },
        },
      },
    },
  },
}

Установіть типову модель

Укажіть для OpenClaw модель comfy/workflow для налаштованої можливості:

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

Перевірте

openclaw models list --provider comfy

Найкраще підходить для: запуску робочих процесів у Comfy Cloud без керування локальними ресурсами GPU.

Отримайте ключ API

Зареєструйтеся на comfy.org і створіть ключ API на панелі керування свого облікового запису.

Установіть ключ API

Надайте ключ одним із наведених способів:

# Onboarding flag
openclaw onboard --comfy-api-key "your-key"

# Environment variable (preferred for daemons)
export COMFY_API_KEY="your-key"

# Alternative environment variable
export COMFY_CLOUD_API_KEY="your-key"

# Or inline in config
openclaw config set plugins.entries.comfy.config.apiKey "your-key"

Підготуйте JSON робочого процесу

Експортуйте або створіть JSON-файл робочого процесу ComfyUI. Занотуйте ідентифікатори вузла введення запиту та вихідного вузла.

Налаштуйте постачальника

Установіть 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`	логічне значення	Дозволяє приватну або локальну `baseUrl` у хмарному режимі чи локальне повне доменне ім’я приватного DNS.

У режимі local літерали loopback- або приватних IP-адрес і однокомпонентні імена служб, як-от http://comfyui:8188, працюють без allowPrivateNetwork. Схожі на публічні повні доменні імена приватного DNS, як-от https://comfy.local.example.com, потребують allowPrivateNetwork: true. Довіра до приватного джерела обмежується налаштованою схемою, іменем хоста та портом; локальні переспрямування не можуть залишати налаштоване ім’я хоста, тоді як хмарні переспрямування до публічних CDN перевіряються за типовою політикою SSRF.

Ключі окремих можливостей

Ці ключі застосовуються всередині розділів image, video або music:

Ключ	Обов’язковий	Типове значення	Опис
`workflow` або `workflowPath`	Так	—	Вбудований JSON робочого процесу або шлях до JSON-файлу робочого процесу ComfyUI.
`promptNodeId`	Так	—	Ідентифікатор вузла, який отримує текстовий запит.
`promptInputName`	Ні	`"text"`	Назва входу у вузлі запиту.
`outputNodeId`	Ні	—	Ідентифікатор вузла, з якого зчитується результат. Якщо не вказано, використовуються всі відповідні вихідні вузли.
`pollIntervalMs`	Ні	`1500`	Інтервал опитування завершення завдання в мілісекундах.
`timeoutMs`	Ні	`300000`	Час очікування запуску робочого процесу в мілісекундах.

Розділи image і video також підтримують вузол введення еталонного зображення:

Ключ	Обов’язковий	Типове значення	Опис
`inputImageNodeId`	Так (під час передавання еталонного зображення)	—	Ідентифікатор вузла, який отримує завантажене еталонне зображення.
`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. Як вхідні дані підтримуються лише текстові запити та одиночні еталонні зображення.

Робочі процеси музики

Вбудований Plugin реєструє постачальника генерування музики для визначених робочим процесом аудіо- або музичних результатів, доступного через спільний інструмент 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.

Пов’язані матеріали

Генерування зображень

Налаштування та використання засобу генерування зображень.

Генерування відео

Налаштування та використання засобу генерування відео.

Генерування музики

Налаштування засобу генерування музики й аудіо.

Каталог постачальників

Огляд усіх постачальників і посилань на моделі.

Довідник із конфігурації

Повний довідник із конфігурації, зокрема типові налаштування агентів.

Overview

Concepts and configuration

Providers

Що підтримується

Початок роботи

Конфігурація

Спільні ключі

Ключі окремих можливостей

Відомості про робочі процеси

Пов’язані матеріали

Генерування зображень

Генерування відео

Генерування музики

Каталог постачальників

Довідник із конфігурації

​Що підтримується

​Початок роботи

​Конфігурація

​Спільні ключі

​Ключі окремих можливостей

​Відомості про робочі процеси

​Пов’язані матеріали

Генерування зображень

Генерування відео

Генерування музики

Каталог постачальників

Довідник із конфігурації

Що підтримується

Початок роботи

Конфігурація

Спільні ключі

Ключі окремих можливостей

Відомості про робочі процеси

Пов’язані матеріали