Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw постачається з вбудованим Plugin comfy для запусків ComfyUI на основі робочих процесів. Plugin повністю керується робочими процесами, тому OpenClaw не намагається зіставляти загальні size, aspectRatio, resolution, durationSeconds або елементи керування в стилі TTS з вашим графом.
PropertyDetail
Providercomfy
Modelscomfy/workflow
Shared surfacesimage_generate, video_generate, music_generate
AuthНемає для локального ComfyUI; COMFY_API_KEY або COMFY_CLOUD_API_KEY для Comfy Cloud
APIComfyUI /prompt / /history / /view та Comfy Cloud /api/*

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

  • Генерація зображень із JSON робочого процесу
  • Редагування зображень з 1 завантаженим референсним зображенням
  • Генерація відео з JSON робочого процесу
  • Генерація відео з 1 завантаженим референсним зображенням
  • Генерація музики або аудіо через спільний інструмент music_generate
  • Завантаження результатів із налаштованого вузла або з усіх відповідних вузлів виводу

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

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

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

Переконайтеся, що ваш локальний екземпляр ComfyUI запущено (типово http://127.0.0.1:8188).
2

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

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

Налаштуйте провайдер

Встановіть 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

Встановіть модель за замовчуванням

Вкажіть для OpenClaw модель comfy/workflow для налаштованої можливості:
{
  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",
          },
        },
      },
    },
  },
}

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

KeyTypeDescription
mode"local" or "cloud"Режим з’єднання.
baseUrlstringТипово http://127.0.0.1:8188 для локального режиму або https://cloud.comfy.org для cloud.
apiKeystringНеобов’язковий вбудований ключ, альтернатива змінним середовища COMFY_API_KEY / COMFY_CLOUD_API_KEY.
allowPrivateNetworkbooleanДозволити приватний/LAN baseUrl у режимі cloud.

​
Ключі для кожної можливості

Ці ключі застосовуються всередині розділів image, video або music:
KeyRequiredDefaultDescription
workflow or workflowPathYes—Шлях до JSON-файлу робочого процесу ComfyUI.
promptNodeIdYes—Ідентифікатор вузла, який отримує текстовий prompt.
promptInputNameNo"text"Назва входу на вузлі prompt.
outputNodeIdNo—Ідентифікатор вузла, з якого читати результат. Якщо не вказано, використовуються всі відповідні вузли виводу.
pollIntervalMsNo—Інтервал опитування в мілісекундах для завершення завдання.
timeoutMsNo—Тайм-аут у мілісекундах для запуску робочого процесу.
Розділи image і video також підтримують:
KeyRequiredDefaultDescription
inputImageNodeIdYes (when passing a reference image)—Ідентифікатор вузла, який отримує завантажене референсне зображення.
inputImageInputNameNo"image"Назва входу на вузлі зображення.

​
Деталі робочого процесу

Встановіть типову модель зображень на comfy/workflow:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Приклад редагування з референсним зображенням:Щоб увімкнути редагування зображень із завантаженим референсним зображенням, додайте inputImageNodeId до конфігурації image:
{
  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. Як вхідні дані підтримуються лише текстові prompt і окремі референсні зображення.
Вбудований Plugin реєструє провайдер генерації музики для визначених робочим процесом аудіо- або музичних виходів, доступний через спільний інструмент 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 функціонально еквівалентні.
Для вбудованого Plugin доступне live-покриття за opt-in:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
Live test пропускає окремі сценарії для зображень, відео або музики, якщо не налаштовано відповідний розділ робочого процесу Comfy.

​
Пов’язане

Генерація зображень

Конфігурація та використання інструмента генерації зображень.

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

Конфігурація та використання інструмента генерації відео.

Генерація музики

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

Каталог провайдерів

Огляд усіх провайдерів і посилань на моделі.

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

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