--- read_when: - Ви хочете використовувати локальні робочі процеси ComfyUI з OpenClaw - Ви хочете використовувати Comfy Cloud із робочими процесами для зображень, відео або музики - Вам потрібні ключі конфігурації вбудованого Plugin comfy summary: Налаштування робочого процесу ComfyUI для генерації зображень, відео та музики в OpenClaw title: ComfyUI x-i18n: generated_at: "2026-04-24T20:32:20Z" model: gpt-5.4 provider: openai source_hash: 41dda4be24d5b2c283fa499a345cf9f38747ec19b4010163ceffd998307ca086 source_path: providers/comfy.md workflow: 15 --- OpenClaw постачається з вбудованим Plugin `comfy` для запусків ComfyUI на основі робочих процесів. Plugin повністю керується робочими процесами, тому OpenClaw не намагається зіставляти загальні `size`, `aspectRatio`, `resolution`, `durationSeconds` або елементи керування в стилі TTS з вашим графом. | Property | Detail | | --------------- | -------------------------------------------------------------------------------------- | | Provider | `comfy` | | Models | `comfy/workflow` | | Shared surfaces | `image_generate`, `video_generate`, `music_generate` | | Auth | Немає для локального ComfyUI; `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` для Comfy Cloud | | API | ComfyUI `/prompt` / `/history` / `/view` та Comfy Cloud `/api/*` | ## Що підтримується - Генерація зображень із JSON робочого процесу - Редагування зображень з 1 завантаженим референсним зображенням - Генерація відео з JSON робочого процесу - Генерація відео з 1 завантаженим референсним зображенням - Генерація музики або аудіо через спільний інструмент `music_generate` - Завантаження результатів із налаштованого вузла або з усіх відповідних вузлів виводу ## Початок роботи Оберіть між запуском ComfyUI на власному комп’ютері або використанням Comfy Cloud. **Найкраще підходить для:** запуску власного екземпляра ComfyUI на вашому комп’ютері або в LAN. Переконайтеся, що ваш локальний екземпляр ComfyUI запущено (типово `http://127.0.0.1:8188`). Експортуйте або створіть JSON-файл робочого процесу ComfyUI. Запишіть ідентифікатори вузлів для вузла введення prompt і вузла виводу, з якого OpenClaw має читати дані. Встановіть `mode: "local"` і вкажіть файл вашого робочого процесу. Ось мінімальний приклад для зображень: ```json5 { 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` для налаштованої можливості: ```json5 { agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, }, } ``` ```bash openclaw models list --provider comfy ``` **Найкраще підходить для:** запуску робочих процесів у Comfy Cloud без керування локальними GPU-ресурсами. Зареєструйтеся на [comfy.org](https://comfy.org) і згенеруйте API-ключ на інформаційній панелі свого облікового запису. Надайте свій ключ одним із цих способів: ```bash # Змінна середовища (рекомендовано) 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. Запишіть ідентифікатори вузлів для вузла введення prompt і вузла виводу. Встановіть `mode: "cloud"` і вкажіть файл вашого робочого процесу: ```json5 { plugins: { entries: { comfy: { config: { mode: "cloud", image: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, }, }, }, }, } ``` У режимі cloud значення `baseUrl` типово дорівнює `https://cloud.comfy.org`. Вам потрібно встановлювати `baseUrl` лише якщо ви використовуєте власну cloud endpoint. ```json5 { agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, }, } ``` ```bash openclaw models list --provider comfy ``` ## Конфігурація Comfy підтримує спільні налаштування з’єднання верхнього рівня, а також розділи робочих процесів для кожної можливості (`image`, `video`, `music`): ```json5 { 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", }, }, }, }, }, } ``` ### Спільні ключі | Key | Type | Description | | --------------------- | ---------------------- | ------------------------------------------------------------------------------------------- | | `mode` | `"local"` or `"cloud"` | Режим з’єднання. | | `baseUrl` | string | Типово `http://127.0.0.1:8188` для локального режиму або `https://cloud.comfy.org` для cloud. | | `apiKey` | string | Необов’язковий вбудований ключ, альтернатива змінним середовища `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY`. | | `allowPrivateNetwork` | boolean | Дозволити приватний/LAN `baseUrl` у режимі cloud. | ### Ключі для кожної можливості Ці ключі застосовуються всередині розділів `image`, `video` або `music`: | Key | Required | Default | Description | | ---------------------------- | -------- | -------- | ---------------------------------------------------------------------------- | | `workflow` or `workflowPath` | Yes | -- | Шлях до JSON-файлу робочого процесу ComfyUI. | | `promptNodeId` | Yes | -- | Ідентифікатор вузла, який отримує текстовий prompt. | | `promptInputName` | No | `"text"` | Назва входу на вузлі prompt. | | `outputNodeId` | No | -- | Ідентифікатор вузла, з якого читати результат. Якщо не вказано, використовуються всі відповідні вузли виводу. | | `pollIntervalMs` | No | -- | Інтервал опитування в мілісекундах для завершення завдання. | | `timeoutMs` | No | -- | Тайм-аут у мілісекундах для запуску робочого процесу. | Розділи `image` і `video` також підтримують: | Key | Required | Default | Description | | --------------------- | ------------------------------------ | --------- | ----------------------------------------------------- | | `inputImageNodeId` | Yes (when passing a reference image) | -- | Ідентифікатор вузла, який отримує завантажене референсне зображення. | | `inputImageInputName` | No | `"image"` | Назва входу на вузлі зображення. | ## Деталі робочого процесу Встановіть типову модель зображень на `comfy/workflow`: ```json5 { agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, }, } ``` **Приклад редагування з референсним зображенням:** Щоб увімкнути редагування зображень із завантаженим референсним зображенням, додайте `inputImageNodeId` до конфігурації `image`: ```json5 { plugins: { entries: { comfy: { config: { image: { workflowPath: "./workflows/edit-api.json", promptNodeId: "6", inputImageNodeId: "7", inputImageInputName: "image", outputNodeId: "9", }, }, }, }, }, } ``` Встановіть типову модель відео на `comfy/workflow`: ```json5 { agents: { defaults: { videoGenerationModel: { primary: "comfy/workflow", }, }, }, } ``` Відеоробочі процеси Comfy підтримують text-to-video та image-to-video через налаштований граф. OpenClaw не передає вхідні відео в робочі процеси Comfy. Як вхідні дані підтримуються лише текстові prompt і окремі референсні зображення. Вбудований Plugin реєструє провайдер генерації музики для визначених робочим процесом аудіо- або музичних виходів, доступний через спільний інструмент `music_generate`: ```text /tool music_generate prompt="Warm ambient synth loop with soft tape texture" ``` Використовуйте розділ конфігурації `music`, щоб вказати JSON вашого аудіоробочого процесу та вузол виводу. Наявна конфігурація зображень верхнього рівня (без вкладеного розділу `image`) усе ще працює: ```json5 { plugins: { entries: { comfy: { config: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, }, }, }, } ``` OpenClaw розглядає цю застарілу форму як конфігурацію робочого процесу для зображень. Вам не потрібно негайно виконувати міграцію, але для нових налаштувань рекомендовано вкладені розділи `image` / `video` / `music`. Якщо ви використовуєте лише генерацію зображень, застаріла плоска конфігурація та новий вкладений розділ `image` функціонально еквівалентні. Для вбудованого Plugin доступне live-покриття за opt-in: ```bash OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts ``` Live test пропускає окремі сценарії для зображень, відео або музики, якщо не налаштовано відповідний розділ робочого процесу Comfy. ## Пов’язане Конфігурація та використання інструмента генерації зображень. Конфігурація та використання інструмента генерації відео. Налаштування інструмента генерації музики та аудіо. Огляд усіх провайдерів і посилань на моделі. Повний довідник із конфігурації, включно з типовими значеннями агентів.