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

Providers

ComfyUI

OpenClaw incluye un plugin comfy integrado para ejecuciones de ComfyUI basadas en flujos de trabajo. El plugin se basa por completo en flujos de trabajo: OpenClaw no asigna controles genéricos de size, aspectRatio, resolution, durationSeconds ni de tipo TTS a su grafo.

Propiedad Detalle
Proveedor comfy
Modelo comfy/workflow
Herramientas compartidas image_generate, video_generate, music_generate
Autenticación Ninguna para ComfyUI local; COMFY_API_KEY o COMFY_CLOUD_API_KEY para Comfy Cloud
API ComfyUI /prompt / /history / /view; Comfy Cloud /api/*

Funcionalidades compatibles

  • Generación y edición de imágenes a partir de un JSON de flujo de trabajo (la edición admite 1 imagen de referencia cargada)
  • Generación de vídeo a partir de un JSON de flujo de trabajo, de texto a vídeo o de imagen a vídeo (1 imagen de referencia)
  • Generación de música/audio mediante la herramienta compartida music_generate, con 1 imagen de referencia opcional
  • Descarga de la salida desde un nodo configurado o desde todos los nodos de salida coincidentes cuando no se configura ninguno

Primeros pasos

Elija entre ejecutar ComfyUI en su propio equipo o utilizar Comfy Cloud.

Local

Opción ideal para: ejecutar su propia instancia de ComfyUI en su equipo o LAN.

  • Iniciar ComfyUI localmente

    Asegúrese de que su instancia local de ComfyUI esté en ejecución (el valor predeterminado es http://127.0.0.1:8188).

  • Preparar el JSON del flujo de trabajo

    Exporte o cree un archivo JSON de flujo de trabajo de ComfyUI. Anote los identificadores de nodo del nodo de entrada del prompt y del nodo de salida que desea que OpenClaw lea.

  • Configurar el proveedor

    Establezca mode: "local" e indique el archivo del flujo de trabajo. Ejemplo mínimo de imagen:

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

  • Establecer el modelo predeterminado

    Configure OpenClaw para que utilice el modelo comfy/workflow en la capacidad que haya configurado:

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

  • Verificar

    bash
    openclaw models list --provider comfy

    • Comfy Cloud

    Opción ideal para: ejecutar flujos de trabajo en Comfy Cloud sin administrar recursos de GPU locales.

  • Obtener una clave de API

    Regístrese en comfy.org y genere una clave de API desde el panel de su cuenta.

  • Establecer la clave de API

    Proporcione su clave mediante cualquiera de estos métodos:

    bash
    # Indicador de incorporaciónopenclaw onboard --comfy-api-key "your-key" # Variable de entorno (preferida para demonios)export COMFY_API_KEY="your-key" # Variable de entorno alternativaexport COMFY_CLOUD_API_KEY="your-key" # O integrada en la configuraciónopenclaw config set plugins.entries.comfy.config.apiKey "your-key"

  • Preparar el JSON del flujo de trabajo

    Exporte o cree un archivo JSON de flujo de trabajo de ComfyUI. Anote los identificadores de nodo del nodo de entrada del prompt y del nodo de salida.

  • Configurar el proveedor

    Establezca mode: "cloud" e indique el archivo del flujo de trabajo:

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

  • Establecer el modelo predeterminado

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

  • Verificar

    bash
    openclaw models list --provider comfy

    • Configuración

    Comfy admite ajustes de conexión compartidos de nivel superior, además de secciones de flujo de trabajo por capacidad (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",          },        },      },    },  },}

    Claves compartidas

    Clave Tipo Descripción
    mode "local" o "cloud" Modo de conexión. El valor predeterminado es "local".
    baseUrl cadena El valor predeterminado es http://127.0.0.1:8188 para local o https://cloud.comfy.org para la nube.
    apiKey cadena Clave integrada opcional, alternativa a las variables de entorno COMFY_API_KEY / COMFY_CLOUD_API_KEY.
    allowPrivateNetwork booleano Permite una baseUrl privada/LAN en modo de nube o un FQDN DNS privado local.

    Claves por capacidad

    Estas claves se aplican dentro de las secciones image, video o music:

    Clave Obligatoria Valor predeterminado Descripción
    workflow o workflowPath Sí -- JSON de flujo de trabajo integrado o ruta al archivo JSON de flujo de trabajo de ComfyUI.
    promptNodeId Sí -- Identificador del nodo que recibe el prompt de texto.
    promptInputName No "text" Nombre de la entrada en el nodo del prompt.
    outputNodeId No -- Identificador del nodo del que se lee la salida. Si se omite, se utilizan todos los nodos de salida coincidentes.
    pollIntervalMs No 1500 Intervalo de sondeo en milisegundos para la finalización del trabajo.
    timeoutMs No 300000 Tiempo de espera en milisegundos para la ejecución del flujo de trabajo.

    Las secciones image y video también admiten un nodo de entrada de imagen de referencia:

    Clave Obligatoria Valor predeterminado Descripción
    inputImageNodeId Sí (al proporcionar una imagen de referencia) -- Identificador del nodo que recibe la imagen de referencia cargada.
    inputImageInputName No "image" Nombre de la entrada en el nodo de imagen.

    apiKey acepta una cadena literal o un objeto de referencia a secreto.

    Detalles del flujo de trabajo

    Flujos de trabajo de imágenes

    Establezca el modelo de imagen predeterminado en comfy/workflow:

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

    Ejemplo de edición con una imagen de referencia:

    Para habilitar la edición de imágenes con una imagen de referencia cargada, añada inputImageNodeId a la configuración de imagen:

    json5
    {  plugins: {    entries: {      comfy: {        config: {          image: {            workflowPath: "./workflows/edit-api.json",            promptNodeId: "6",            inputImageNodeId: "7",            inputImageInputName: "image",            outputNodeId: "9",          },        },      },    },  },}
    Flujos de trabajo de vídeo

    Establezca el modelo de vídeo predeterminado en comfy/workflow:

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

    Los flujos de trabajo de vídeo de Comfy admiten la conversión de texto a vídeo y de imagen a vídeo mediante el grafo configurado.

    Flujos de trabajo de música

    El plugin integrado registra un proveedor de generación de música para salidas de audio o música definidas por el flujo de trabajo, disponible mediante la herramienta compartida music_generate. Acepta una imagen de referencia opcional (hasta 1):

    text
    /tool music_generate prompt="Bucle cálido de sintetizador ambiental con una suave textura de cinta"

    Utilice la sección de configuración music para indicar el JSON del flujo de trabajo de audio y el nodo de salida.

    Compatibilidad con versiones anteriores

    La configuración de imagen de nivel superior existente (sin la sección image anidada) sigue funcionando:

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

    OpenClaw trata esa estructura heredada como la configuración del flujo de trabajo de imágenes. No es necesario migrar inmediatamente, pero se recomiendan las secciones anidadas image / video / music para las nuevas configuraciones. Si solo se utiliza la generación de imágenes, la configuración plana heredada y la nueva sección anidada image son funcionalmente equivalentes.

    Pruebas en vivo

    El Plugin incluido dispone de cobertura de pruebas en vivo opcional:

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

    La prueba en vivo omite los casos individuales de imágenes, vídeos o música, a menos que esté configurada la sección correspondiente del flujo de trabajo de Comfy.

    Contenido relacionado

    Generación de imágenes

    Configuración y uso de la herramienta de generación de imágenes.
    Generación de vídeos

    Configuración y uso de la herramienta de generación de vídeos.
    Generación de música

    Configuración de la herramienta de generación de música y audio.
    Directorio de proveedores

    Descripción general de todos los proveedores y referencias de modelos.
    Referencia de configuración

    Referencia completa de la configuración, incluidos los valores predeterminados de los agentes.
    Was this useful?
    On this page

    On this page