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 ejecutar ComfyUI mediante flujos de trabajo. El plugin se controla por completo mediante flujos de trabajo: OpenClaw no asigna controles genéricos de size, aspectRatio, resolution, durationSeconds ni controles similares a los de TTS a tu 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 mediante un JSON de flujo de trabajo (la edición admite 1 imagen de referencia subida)
  • Generación de vídeo mediante 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 del resultado desde un Node configurado o desde todos los Nodes de salida coincidentes cuando no se configura ninguno

Primeros pasos

Elige entre ejecutar ComfyUI en tu propio equipo o usar Comfy Cloud.

Local

Opción recomendada para: ejecutar tu propia instancia de ComfyUI en tu equipo o LAN.

  • Iniciar ComfyUI localmente

    Asegúrate de que tu 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

    Exporta o crea un archivo JSON de flujo de trabajo de ComfyUI. Anota los identificadores de Node correspondientes al Node de entrada de la instrucción y al Node de salida que quieras que OpenClaw lea.

  • Configurar el proveedor

    Establece mode: "local" e indica tu archivo de flujo de trabajo. Ejemplo mínimo para imágenes:

    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

    Configura OpenClaw para que use el modelo comfy/workflow con la funcionalidad que hayas configurado:

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

  • Verificar

    bash
    openclaw models list --provider comfy

    • Comfy Cloud

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

  • Obtener una clave de API

    Regístrate en comfy.org y genera una clave de API desde el panel de tu cuenta.

  • Establecer la clave de API

    Proporciona tu clave mediante cualquiera de estos métodos:

    bash
    # 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"

  • Preparar el JSON del flujo de trabajo

    Exporta o crea un archivo JSON de flujo de trabajo de ComfyUI. Anota los identificadores de Node correspondientes al Node de entrada de la instrucción y al Node de salida.

  • Configurar el proveedor

    Establece mode: "cloud" e indica tu archivo de 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 opciones de conexión compartidas de nivel superior y secciones de flujo de trabajo para cada funcionalidad (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 el modo local o https://cloud.comfy.org para la nube.
    apiKey cadena Clave insertada opcional, alternativa a las variables de entorno COMFY_API_KEY / COMFY_CLOUD_API_KEY.
    allowPrivateNetwork booleano Permite una baseUrl privada/de LAN en modo de nube o un FQDN DNS privado local.

    Claves por funcionalidad

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

    Clave Obligatoria Valor predeterminado Descripción
    workflow o workflowPath Sí -- JSON del flujo de trabajo insertado o ruta al archivo JSON del flujo de trabajo de ComfyUI.
    promptNodeId Sí -- Identificador del Node que recibe la instrucción de texto.
    promptInputName No "text" Nombre de la entrada en el Node de la instrucción.
    outputNodeId No -- Identificador del Node desde el que se lee el resultado. Si se omite, se usan todos los Nodes de salida coincidentes.
    pollIntervalMs No 1500 Intervalo de sondeo en milisegundos para determinar 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 Node de entrada para una imagen de referencia:

    Clave Obligatoria Valor predeterminado Descripción
    inputImageNodeId Sí (cuando se proporciona una imagen de referencia) -- Identificador del Node que recibe la imagen de referencia subida.
    inputImageInputName No "image" Nombre de la entrada en el Node de imagen.

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

    Detalles del flujo de trabajo

    Flujos de trabajo de imágenes

    Establece 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 subida, añade inputImageNodeId a la configuración de imágenes:

    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

    Establece 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 resultados de audio o música definidos por el flujo de trabajo, disponible mediante la herramienta compartida music_generate. Admite una imagen de referencia opcional (como máximo 1):

    text
    /tool music_generate prompt="Warm ambient synth loop with soft tape texture"

    Usa la sección de configuración music para indicar el JSON de tu flujo de trabajo de audio y el Node de salida.

    Compatibilidad con versiones anteriores

    La configuración de imágenes 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 necesitas migrarla de inmediato, pero se recomiendan las secciones anidadas image / video / music para las configuraciones nuevas. Si solo usas la generación de imágenes, la configuración plana heredada y la nueva sección image anidada son funcionalmente equivalentes.

    Pruebas en vivo

    El plugin integrado dispone de cobertura 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 imagen, vídeo o música, a menos que esté configurada la sección correspondiente del flujo de trabajo de Comfy.

    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 configuración, incluidos los valores predeterminados de los agentes.
    Was this useful?
    On this page

    On this page