ComfyUI

OpenClaw wordt geleverd met een gebundelde comfy-plugin voor workflowgestuurde ComfyUI-uitvoeringen. De plugin is volledig workflowgestuurd: OpenClaw koppelt geen algemene size-, aspectRatio-, resolution-, durationSeconds- of TTS-achtige bedieningselementen aan jouw graaf.

Eigenschap	Details
Provider	`comfy`
Model	`comfy/workflow`
Gedeelde tools	`image_generate`, `video_generate`, `music_generate`
Authenticatie	Geen voor lokale ComfyUI; `COMFY_API_KEY` of `COMFY_CLOUD_API_KEY` voor Comfy Cloud
API	ComfyUI `/prompt` / `/history` / `/view`; Comfy Cloud `/api/*`

Wat wordt ondersteund

Afbeeldingen genereren en bewerken vanuit een workflow-JSON (voor bewerken is 1 geüploade referentieafbeelding nodig)
Video’s genereren vanuit een workflow-JSON, van tekst naar video of van afbeelding naar video (1 referentieafbeelding)
Muziek/audio genereren via de gedeelde tool music_generate, met optioneel 1 referentieafbeelding
Uitvoer downloaden van een geconfigureerd knooppunt, of van alle overeenkomende uitvoerknooppunten wanneer er geen is geconfigureerd

Aan de slag

Kies tussen het uitvoeren van ComfyUI op je eigen computer en het gebruik van Comfy Cloud.

Lokaal
Comfy Cloud

Meest geschikt voor: het uitvoeren van je eigen ComfyUI-instantie op je computer of LAN.

Start ComfyUI lokaal

Zorg ervoor dat je lokale ComfyUI-instantie actief is (standaard http://127.0.0.1:8188).

Bereid je workflow-JSON voor

Exporteer of maak een ComfyUI-workflow-JSON-bestand. Noteer de knooppunt-ID’s van het invoerknooppunt voor de prompt en het uitvoerknooppunt waarvan OpenClaw moet lezen.

Configureer de provider

Stel mode: "local" in en verwijs naar je workflowbestand. Minimaal voorbeeld voor afbeeldingen:

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

Stel het standaardmodel in

Laat OpenClaw voor de geconfigureerde mogelijkheid naar het model comfy/workflow verwijzen:

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

Verifieer

openclaw models list --provider comfy

Meest geschikt voor: workflows uitvoeren in Comfy Cloud zonder lokale GPU-resources te beheren.

Verkrijg een API-sleutel

Meld je aan bij comfy.org en genereer een API-sleutel via het dashboard van je account.

Stel de API-sleutel in

Geef je sleutel op via een van deze methoden:

# Onboarding-vlag
openclaw onboard --comfy-api-key "your-key"

# Omgevingsvariabele (aanbevolen voor daemons)
export COMFY_API_KEY="your-key"

# Alternatieve omgevingsvariabele
export COMFY_CLOUD_API_KEY="your-key"

# Of rechtstreeks in de configuratie
openclaw config set plugins.entries.comfy.config.apiKey "your-key"

Bereid je workflow-JSON voor

Exporteer of maak een ComfyUI-workflow-JSON-bestand. Noteer de knooppunt-ID’s van het invoerknooppunt voor de prompt en het uitvoerknooppunt.

Configureer de provider

Stel mode: "cloud" in en verwijs naar je workflowbestand:

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

In cloudmodus wordt baseUrl standaard ingesteld op https://cloud.comfy.org. Stel baseUrl alleen in voor een aangepast cloudeindpunt.

Stel het standaardmodel in

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

Verifieer

openclaw models list --provider comfy

Configuratie

Comfy ondersteunt gedeelde verbindingsinstellingen op het hoogste niveau en workflowsecties per mogelijkheid (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",
          },
        },
      },
    },
  },
}

Gedeelde sleutels

Sleutel	Type	Beschrijving
`mode`	`"local"` of `"cloud"`	Verbindingsmodus. Standaard `"local"`.
`baseUrl`	tekenreeks	Standaard `http://127.0.0.1:8188` voor lokaal of `https://cloud.comfy.org` voor de cloud.
`apiKey`	tekenreeks	Optionele inline sleutel, als alternatief voor de omgevingsvariabelen `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY`.
`allowPrivateNetwork`	booleaans	Sta een privé-/LAN-`baseUrl` toe in cloudmodus of een lokale privé-DNS-FQDN.

In de modus local werken letterlijke loopback-/privé-IP-adressen en servicenames met één label, zoals http://comfyui:8188, zonder allowPrivateNetwork. Privé-DNS-FQDN’s die er openbaar uitzien, zoals https://comfy.local.example.com, vereisen allowPrivateNetwork: true. Vertrouwen in een privé-oorsprong blijft beperkt tot het geconfigureerde schema, de hostnaam en de poort; lokale omleidingen kunnen de geconfigureerde hostnaam niet verlaten, terwijl cloudomleidingen naar openbare CDN’s worden gecontroleerd met het standaard-SSRF-beleid.

Sleutels per mogelijkheid

Deze sleutels zijn van toepassing binnen de secties image, video of music:

Sleutel	Vereist	Standaard	Beschrijving
`workflow` of `workflowPath`	Ja	—	Inline workflow-JSON of het pad naar het ComfyUI-workflow-JSON-bestand.
`promptNodeId`	Ja	—	Knooppunt-ID dat de tekstprompt ontvangt.
`promptInputName`	Nee	`"text"`	Invoernaam op het promptknooppunt.
`outputNodeId`	Nee	—	Knooppunt-ID waarvan de uitvoer wordt gelezen. Indien weggelaten, worden alle overeenkomende uitvoerknooppunten gebruikt.
`pollIntervalMs`	Nee	`1500`	Pollinginterval in milliseconden voor het voltooien van de taak.
`timeoutMs`	Nee	`300000`	Time-out in milliseconden voor de uitvoering van de workflow.

De secties image en video ondersteunen ook een invoerknooppunt voor referentieafbeeldingen:

Sleutel	Vereist	Standaard	Beschrijving
`inputImageNodeId`	Ja (wanneer een referentieafbeelding wordt doorgegeven)	—	Knooppunt-ID dat de geüploade referentieafbeelding ontvangt.
`inputImageInputName`	Nee	`"image"`	Invoernaam op het afbeeldingsknooppunt.

apiKey accepteert een letterlijke tekenreeks of een geheimverwijzing-object.

Workflowdetails

Afbeeldingsworkflows

Stel het standaardafbeeldingsmodel in op comfy/workflow:

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

Voorbeeld van bewerken met een referentieafbeelding:Voeg inputImageNodeId toe aan je afbeeldingsconfiguratie om afbeeldingen te kunnen bewerken met een geüploade referentieafbeelding:

{
  plugins: {
    entries: {
      comfy: {
        config: {
          image: {
            workflowPath: "./workflows/edit-api.json",
            promptNodeId: "6",
            inputImageNodeId: "7",
            inputImageInputName: "image",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}

Videoworkflows

Stel het standaardvideomodel in op comfy/workflow:

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

Comfy-videoworkflows ondersteunen tekst-naar-video en afbeelding-naar-video via de geconfigureerde graaf.

OpenClaw geeft geen invoervideo’s door aan Comfy-workflows. Alleen tekstprompts en afzonderlijke referentieafbeeldingen worden als invoer ondersteund.

Muziekworkflows

De gebundelde plugin registreert een provider voor het genereren van muziek voor door workflows gedefinieerde audio- of muziekuitvoer, beschikbaar via de gedeelde tool music_generate. Deze accepteert een optionele referentieafbeelding (maximaal 1):

/tool music_generate prompt="Warme ambient-synthloop met zachte bandtextuur"

Gebruik de configuratiesectie music om naar de JSON van je audioworkflow en het uitvoerknooppunt te verwijzen.

Achterwaartse compatibiliteit

Bestaande afbeeldingsconfiguratie op het hoogste niveau (zonder de geneste sectie image) blijft werken:

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

OpenClaw behandelt die verouderde vorm als de configuratie voor de afbeeldingsworkflow. Je hoeft niet onmiddellijk te migreren, maar de geneste secties image / video / music worden aanbevolen voor nieuwe configuraties. Als je alleen afbeeldingsgeneratie gebruikt, zijn de verouderde platte configuratie en de nieuwe geneste sectie image functioneel gelijkwaardig.

Live-tests

Voor de gebundelde plugin is optionele live-testdekking beschikbaar:

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

De live-test slaat afzonderlijke gevallen voor afbeeldingen, video’s of muziek over, tenzij de bijbehorende Comfy-workflowsectie is geconfigureerd.

Gerelateerd

Afbeeldingen genereren

Configuratie en gebruik van de tool voor afbeeldingsgeneratie.

Video's genereren

Configuratie en gebruik van de tool voor videogeneratie.

Muziek genereren

Instellen van de tool voor muziek- en audiogeneratie.

Provideroverzicht

Overzicht van alle providers en modelreferenties.

Configuratiereferentie

Volledige configuratiereferentie, inclusief standaardinstellingen voor agents.

Overview

Concepts and configuration

Providers

Wat wordt ondersteund

Aan de slag

Configuratie

Gedeelde sleutels

Sleutels per mogelijkheid

Workflowdetails

Gerelateerd

Afbeeldingen genereren

Video's genereren

Muziek genereren

Provideroverzicht

Configuratiereferentie

​Wat wordt ondersteund

​Aan de slag

​Configuratie

​Gedeelde sleutels

​Sleutels per mogelijkheid

​Workflowdetails

​Gerelateerd

Afbeeldingen genereren

Video's genereren

Muziek genereren

Provideroverzicht

Configuratiereferentie

Wat wordt ondersteund

Aan de slag

Configuratie

Gedeelde sleutels

Sleutels per mogelijkheid

Workflowdetails

Gerelateerd