Providers
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.
Локально
Найкраще підходить для: запуску власного екземпляра 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 comfyComfy Cloud
Найкраще підходить для: запуску робочих процесів у Comfy Cloud без керування локальними ресурсами GPU.
Отримайте ключ API
Зареєструйтеся на comfy.org і створіть ключ API на панелі керування свого облікового запису.
Установіть ключ API
Надайте ключ одним із наведених способів:
# Onboarding flagopenclaw onboard --comfy-api-key "your-key" # Environment variable (preferred for daemons)export COMFY_API_KEY="your-key" # Alternative environment variableexport COMFY_CLOUD_API_KEY="your-key" # Or inline in configopenclaw 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", }, }, }, }, },}Установіть типову модель
{ 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. |
Ключі окремих можливостей
Ці ключі застосовуються всередині розділів 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 підтримують створення відео з тексту та зображення через налаштований граф.
Робочі процеси музики
Вбудований 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.
Пов’язані матеріали
Налаштування та використання засобу генерування зображень.
Налаштування та використання засобу генерування відео.
Налаштування засобу генерування музики й аудіо.
Огляд усіх постачальників і посилань на моделі.
Повний довідник із конфігурації, зокрема типові налаштування агентів.
