ComfyUI

OpenClaw поставляется со встроенным плагином comfy для запуска ComfyUI на основе рабочих процессов. Плагин полностью управляется рабочим процессом: 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

Передайте ключ любым из следующих способов:

# Флаг первоначальной настройки
openclaw onboard --comfy-api-key "your-key"

# Переменная окружения (предпочтительно для фоновых служб)
export COMFY_API_KEY="your-key"

# Альтернативная переменная окружения
export COMFY_CLOUD_API_KEY="your-key"

# Или непосредственно в конфигурации
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 литералы кольцевых и частных 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. В качестве входных данных поддерживаются только текстовые запросы и одно эталонное изображение.

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

Встроенный плагин регистрирует провайдер генерации музыки для аудио- или музыкальных результатов, определенных рабочим процессом и доступных через общий инструмент music_generate. Он принимает необязательное эталонное изображение (до 1):

/tool music_generate prompt="Теплый эмбиентный синтезаторный луп с мягкой пленочной текстурой"

Используйте раздел конфигурации music, чтобы указать JSON аудиопроцесса и выходной узел.

Обратная совместимость

Существующая конфигурация изображений верхнего уровня (без вложенного раздела image) продолжает работать:

{
  plugins: {
    entries: {
      comfy: {
        config: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}

OpenClaw интерпретирует эту устаревшую структуру как конфигурацию рабочего процесса генерации изображений. Немедленная миграция не требуется, но для новых конфигураций рекомендуется использовать вложенные разделы image / video / music. Если вы используете только генерацию изображений, устаревшая плоская конфигурация и новый вложенный раздел image функционально эквивалентны.

Интерактивные тесты

Для встроенного плагина доступно подключаемое интерактивное тестовое покрытие:

OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts

Интерактивный тест пропускает отдельные сценарии для изображений, видео или музыки, если не настроен соответствующий раздел рабочего процесса Comfy.

Связанные материалы

Генерация изображений

Настройка и использование инструмента генерации изображений.

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

Настройка и использование инструмента генерации видео.

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

Настройка инструмента генерации музыки и аудио.

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

Обзор всех провайдеров и ссылок на модели.

Справочник по конфигурации

Полный справочник по конфигурации, включая настройки агентов по умолчанию.

Overview

Concepts and configuration

Providers

Поддерживаемые возможности

Начало работы

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

Общие ключи

Ключи отдельных возможностей

Сведения о рабочих процессах

Связанные материалы

Генерация изображений

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

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

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

Справочник по конфигурации

​Поддерживаемые возможности

​Начало работы

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

​Общие ключи

​Ключи отдельных возможностей

​Сведения о рабочих процессах

​Связанные материалы

Генерация изображений

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

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

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

Справочник по конфигурации

Поддерживаемые возможности

Начало работы

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

Общие ключи

Ключи отдельных возможностей

Сведения о рабочих процессах

Связанные материалы