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

Providers

ComfyUI

OpenClaw levert een gebundelde comfy-Plugin voor workflowgestuurde ComfyUI-uitvoeringen. De Plugin is volledig workflowgestuurd: OpenClaw koppelt algemene instellingen zoals size, aspectRatio, resolution, durationSeconds of TTS-achtige bedieningselementen niet aan je grafiek.

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 geconfigureerde Node, of van alle overeenkomende uitvoer-Nodes wanneer er geen is geconfigureerd

Aan de slag

Kies tussen ComfyUI uitvoeren op je eigen machine en Comfy Cloud gebruiken.

Lokaal

Het meest geschikt voor: je eigen ComfyUI-instantie uitvoeren op je machine of LAN.

  • ComfyUI lokaal starten

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

  • Je workflow-JSON voorbereiden

    Exporteer of maak een ComfyUI-workflow-JSON-bestand. Noteer de Node-ID's van de invoer-Node voor de prompt en de uitvoer-Node waarvan OpenClaw moet lezen.

  • De provider configureren

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

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

  • Het standaardmodel instellen

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

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

  • Verifiëren

    bash
    openclaw models list --provider comfy

    • Comfy Cloud

    Het meest geschikt voor: workflows uitvoeren op Comfy Cloud zonder lokale GPU-resources te beheren.

  • Een API-sleutel verkrijgen

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

  • De API-sleutel instellen

    Geef je sleutel op via een van deze methoden:

    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"

  • Je workflow-JSON voorbereiden

    Exporteer of maak een ComfyUI-workflow-JSON-bestand. Noteer de Node-ID's van de invoer-Node voor de prompt en de uitvoer-Node.

  • De provider configureren

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

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

  • Het standaardmodel instellen

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

  • Verifiëren

    bash
    openclaw models list --provider comfy

    • Configuratie

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

    Gedeelde sleutels

    Sleutel Type Beschrijving
    mode "local" of "cloud" Verbindingsmodus. Standaardwaarde is "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 booleaanse waarde Sta in de cloudmodus een privé-/LAN-baseUrl of een lokale privé-DNS-FQDN toe.

    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 pad naar het ComfyUI-workflow-JSON-bestand.
    promptNodeId Ja -- Node-ID die de tekstprompt ontvangt.
    promptInputName Nee "text" Naam van de invoer op de prompt-Node.
    outputNodeId Nee -- Node-ID waarvan de uitvoer wordt gelezen. Indien weggelaten, worden alle overeenkomende uitvoer-Nodes gebruikt.
    pollIntervalMs Nee 1500 Pollinginterval in milliseconden voor het voltooien van de taak.
    timeoutMs Nee 300000 Time-out in milliseconden voor de workflowuitvoering.

    De secties image en video ondersteunen ook een invoer-Node voor een referentieafbeelding:

    Sleutel Vereist Standaard Beschrijving
    inputImageNodeId Ja (bij het meegeven van een referentieafbeelding) -- Node-ID die de geüploade referentieafbeelding ontvangt.
    inputImageInputName Nee "image" Naam van de invoer op de afbeeldings-Node.

    apiKey accepteert een letterlijke tekenreeks of een geheimreferentie-object.

    Workflowdetails

    Afbeeldingsworkflows

    Stel het standaardmodel voor afbeeldingen in op comfy/workflow:

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

    Voorbeeld voor bewerken met een referentieafbeelding:

    Voeg inputImageNodeId toe aan je afbeeldingsconfiguratie om bewerken met een geüploade referentieafbeelding in te schakelen:

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

    Stel het standaardmodel voor video in op comfy/workflow:

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

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

    Muziekworkflows

    De gebundelde Plugin registreert een provider voor muziekgeneratie voor door workflows gedefinieerde audio- of muziekuitvoer, die beschikbaar wordt gesteld via de gedeelde tool music_generate. Deze accepteert een optionele referentieafbeelding (maximaal 1):

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

    Gebruik de configuratiesectie music om naar je audio-workflow-JSON en uitvoer-Node te verwijzen.

    Achterwaartse compatibiliteit

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

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

    OpenClaw behandelt die verouderde structuur 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

    Er is optionele live-testdekking beschikbaar voor de gebundelde Plugin:

    bash
    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 het hulpmiddel voor het genereren van afbeeldingen.
    Video’s genereren

    Configuratie en gebruik van het hulpmiddel voor het genereren van video’s.
    Muziek genereren

    Instellen van het hulpmiddel voor het genereren van muziek en audio.
    Provideroverzicht

    Overzicht van alle providers en modelreferenties.
    Configuratiereferentie

    Volledige configuratiereferentie, inclusief standaardinstellingen voor agents.
    Was this useful?
    On this page

    On this page