OpenClawDocs
На этой странице

На этой странице

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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.

Локально

Лучше всего подходит для: запуска собственного экземпляра ComfyUI на компьютере или в локальной сети.

  • Запустите ComfyUI локально

    Убедитесь, что локальный экземпляр ComfyUI запущен (по умолчанию используется http://127.0.0.1:8188).

  • Подготовьте JSON рабочего процесса

    Экспортируйте или создайте JSON-файл рабочего процесса ComfyUI. Запишите идентификаторы узла ввода запроса и выходного узла, из которого 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

    Лучше всего подходит для: запуска рабочих процессов в Comfy Cloud без управления локальными ресурсами GPU.

  • Получите ключ API

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

  • Задайте ключ API

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

    bash
    # Флаг первоначальной настройки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" и укажите файл рабочего процесса:

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

  • Задайте модель по умолчанию

    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",          },        },      },    },  },}

    Общие ключи

    Ключ Тип Описание
    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:

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

    Пример редактирования с эталонным изображением:

    Чтобы включить редактирование изображений с загруженным эталонным изображением, добавьте inputImageNodeId в конфигурацию изображений:

    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 поддерживают генерацию видео из текста и изображения с помощью настроенного графа.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Обзор всех провайдеров и ссылок на модели.
    Справочник по конфигурации

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