Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw include un Plugin comfy che fornisce esecuzioni ComfyUI guidate da workflow. Il Plugin è interamente guidato dal workflow, quindi OpenClaw non prova a mappare controlli generici come size, aspectRatio, resolution, durationSeconds o controlli in stile TTS sul tuo grafo.
ProprietàDettaglio
Providercomfy
Modellicomfy/workflow
Superfici condiviseimage_generate, video_generate, music_generate
AutenticazioneNessuna per ComfyUI locale; COMFY_API_KEY o COMFY_CLOUD_API_KEY per Comfy Cloud
APIComfyUI /prompt / /history / /view e Comfy Cloud /api/*

​
Cosa supporta

  • Generazione di immagini da un workflow JSON
  • Modifica di immagini con 1 immagine di riferimento caricata
  • Generazione video da un workflow JSON
  • Generazione video con 1 immagine di riferimento caricata
  • Generazione di musica o audio tramite lo strumento condiviso music_generate
  • Download dell’output da un nodo configurato o da tutti i nodi di output corrispondenti

​
Per iniziare

Scegli tra eseguire ComfyUI sulla tua macchina oppure usare Comfy Cloud.
Ideale per: eseguire la tua istanza ComfyUI sulla tua macchina o LAN.
1

Avvia ComfyUI in locale

Assicurati che la tua istanza ComfyUI locale sia in esecuzione (predefinito http://127.0.0.1:8188).
2

Prepara il tuo workflow JSON

Esporta o crea un file JSON di workflow ComfyUI. Annota gli ID dei nodi per il nodo di input del prompt e per il nodo di output da cui vuoi che OpenClaw legga.
3

Configura il provider

Imposta mode: "local" e punta al file del workflow. Ecco un esempio minimo per immagini:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          mode: "local",
          baseUrl: "http://127.0.0.1:8188",
          image: {
            workflowPath: "./workflows/flux-api.json",
            promptNodeId: "6",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
4

Imposta il modello predefinito

Punta OpenClaw al modello comfy/workflow per la capability che hai configurato:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

Verifica

openclaw models list --provider comfy

​
Configurazione

Comfy supporta impostazioni di connessione condivise di primo livello più sezioni di workflow per capability (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",
          },
        },
      },
    },
  },
}

​
Chiavi condivise

ChiaveTipoDescrizione
mode"local" o "cloud"Modalità di connessione.
baseUrlstringPredefinito http://127.0.0.1:8188 per locale o https://cloud.comfy.org per cloud.
apiKeystringChiave inline facoltativa, alternativa alle variabili env COMFY_API_KEY / COMFY_CLOUD_API_KEY.
allowPrivateNetworkbooleanConsente un baseUrl privato/LAN in modalità cloud.

​
Chiavi per capability

Queste chiavi si applicano dentro le sezioni image, video o music:
ChiaveObbligatoriaPredefinitoDescrizione
workflow o workflowPathSì—Percorso al file JSON del workflow ComfyUI.
promptNodeIdSì—ID del nodo che riceve il prompt testuale.
promptInputNameNo"text"Nome dell’input sul nodo del prompt.
outputNodeIdNo—ID del nodo da cui leggere l’output. Se omesso, vengono usati tutti i nodi di output corrispondenti.
pollIntervalMsNo—Intervallo di polling in millisecondi per il completamento del job.
timeoutMsNo—Timeout in millisecondi per l’esecuzione del workflow.
Le sezioni image e video supportano anche:
ChiaveObbligatoriaPredefinitoDescrizione
inputImageNodeIdSì (quando si passa un’immagine di riferimento)—ID del nodo che riceve l’immagine di riferimento caricata.
inputImageInputNameNo"image"Nome dell’input sul nodo immagine.

​
Dettagli del workflow

Imposta il modello immagine predefinito su comfy/workflow:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Esempio di modifica con immagine di riferimento:Per abilitare la modifica immagini con un’immagine di riferimento caricata, aggiungi inputImageNodeId alla tua configurazione immagine:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          image: {
            workflowPath: "./workflows/edit-api.json",
            promptNodeId: "6",
            inputImageNodeId: "7",
            inputImageInputName: "image",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
Imposta il modello video predefinito su comfy/workflow:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
I workflow video Comfy supportano text-to-video e image-to-video tramite il grafo configurato.
OpenClaw non passa video di input nei workflow Comfy. Sono supportati come input solo prompt testuali e singole immagini di riferimento.
Il Plugin incluso registra un provider di generazione musicale per output audio o musicali definiti dal workflow, esposti tramite lo strumento condiviso music_generate:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
Usa la sezione di configurazione music per puntare al tuo workflow JSON audio e al nodo di output.
La configurazione immagine esistente di primo livello (senza la sezione annidata image) continua a funzionare:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}
OpenClaw tratta questa forma legacy come configurazione del workflow immagine. Non devi migrare subito, ma le sezioni annidate image / video / music sono consigliate per le nuove configurazioni.
Se usi solo la generazione di immagini, la configurazione flat legacy e la nuova sezione annidata image sono funzionalmente equivalenti.
Esiste copertura live opt-in per il Plugin incluso:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
Il test live salta i singoli casi immagine, video o musica a meno che la sezione di workflow Comfy corrispondente non sia configurata.

​
Correlati

Generazione di immagini

Configurazione e utilizzo dello strumento di generazione di immagini.

Generazione video

Configurazione e utilizzo dello strumento di generazione video.

Generazione musicale

Configurazione dello strumento per la generazione di musica e audio.

Directory dei provider

Panoramica di tutti i provider e riferimenti ai modelli.

Riferimento della configurazione

Riferimento completo della configurazione, inclusi i valori predefiniti degli agenti.