Naar hoofdinhoud gaan

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 levert een gebundelde comfy plugin voor workflow-gestuurde ComfyUI-runs. De plugin is volledig workflow-gestuurd, dus OpenClaw probeert geen generieke size-, aspectRatio-, resolution-, durationSeconds- of TTS-achtige bedieningselementen op je grafiek te mappen.
EigenschapDetail
Providercomfy
Modellencomfy/workflow
Gedeelde oppervlakkenimage_generate, video_generate, music_generate
AuthGeen voor lokale ComfyUI; COMFY_API_KEY of COMFY_CLOUD_API_KEY voor Comfy Cloud
APIComfyUI /prompt / /history / /view en Comfy Cloud /api/*

​
Wat het ondersteunt

  • Afbeeldingen genereren vanuit een workflow-JSON
  • Afbeeldingen bewerken met 1 geüploade referentieafbeelding
  • Video’s genereren vanuit een workflow-JSON
  • Video’s genereren met 1 geüploade referentieafbeelding
  • Muziek- of audiogeneratie via de gedeelde tool music_generate
  • Uitvoer downloaden vanaf een geconfigureerd knooppunt of alle overeenkomende uitvoerknooppunten

​
Aan de slag

Kies tussen ComfyUI draaien op je eigen machine of Comfy Cloud gebruiken.
Beste voor: je eigen ComfyUI-instantie draaien op je machine of LAN.
1

Start ComfyUI lokaal

Zorg dat je lokale ComfyUI-instantie draait (standaard http://127.0.0.1:8188).
2

Bereid je workflow-JSON voor

Exporteer of maak een ComfyUI-workflow-JSON-bestand. Noteer de knooppunt-ID’s voor het promptinvoerknooppunt en het uitvoerknooppunt waaruit je OpenClaw wilt laten lezen.
3

Configureer de provider

Stel mode: "local" in en verwijs naar je workflowbestand. Hier is een minimaal afbeeldingsvoorbeeld:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          mode: "local",
          baseUrl: "http://127.0.0.1:8188",
          image: {
            workflowPath: "./workflows/flux-api.json",
            promptNodeId: "6",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
4

Stel het standaardmodel in

Verwijs OpenClaw naar het model comfy/workflow voor de capability die je hebt geconfigureerd:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

Verifieer

openclaw models list --provider comfy

​
Configuratie

Comfy ondersteunt gedeelde verbindingsinstellingen op topniveau plus workflowsecties 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",
          },
        },
      },
    },
  },
}

​
Gedeelde sleutels

SleutelTypeBeschrijving
mode"local" of "cloud"Verbindingsmodus.
baseUrlstringStandaard http://127.0.0.1:8188 voor lokaal of https://cloud.comfy.org voor cloud.
apiKeystringOptionele inline sleutel, alternatief voor de env-vars COMFY_API_KEY / COMFY_CLOUD_API_KEY.
allowPrivateNetworkbooleanSta een privé-/LAN-baseUrl toe in cloudmodus.

​
Sleutels per capability

Deze sleutels zijn van toepassing binnen de secties image, video of music:
SleutelVereistStandaardBeschrijving
workflow of workflowPathJa—Pad naar het ComfyUI-workflow-JSON-bestand.
promptNodeIdJa—Knooppunt-ID dat de tekstprompt ontvangt.
promptInputNameNee"text"Invoernaam op het promptknooppunt.
outputNodeIdNee—Knooppunt-ID om uitvoer uit te lezen. Indien weggelaten, worden alle overeenkomende uitvoerknooppunten gebruikt.
pollIntervalMsNee—Pollinginterval in milliseconden voor voltooiing van de taak.
timeoutMsNee—Timeout in milliseconden voor de workflow-run.
De secties image en video ondersteunen ook:
SleutelVereistStandaardBeschrijving
inputImageNodeIdJa (bij het doorgeven van een referentieafbeelding)—Knooppunt-ID dat de geüploade referentieafbeelding ontvangt.
inputImageInputNameNee"image"Invoernaam op het afbeeldingsknooppunt.

​
Workflowdetails

Stel het standaardafbeeldingsmodel in op comfy/workflow:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Voorbeeld voor bewerken met referentieafbeelding:Voeg inputImageNodeId toe aan je afbeeldingsconfiguratie om afbeeldingsbewerking met een geüploade referentieafbeelding in te schakelen:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          image: {
            workflowPath: "./workflows/edit-api.json",
            promptNodeId: "6",
            inputImageNodeId: "7",
            inputImageInputName: "image",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
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 grafiek.
OpenClaw geeft geen invoervideo’s door aan Comfy-workflows. Alleen tekstprompts en afzonderlijke referentieafbeeldingen worden ondersteund als invoer.
De gebundelde plugin registreert een provider voor muziekgeneratie voor door workflows gedefinieerde audio- of muziekuitvoer, beschikbaar via de gedeelde tool music_generate:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
Gebruik de configuratiesectie music om naar je audio-workflow-JSON en uitvoerknooppunt te verwijzen.
Bestaande afbeeldingsconfiguratie op topniveau (zonder de geneste sectie image) werkt nog steeds:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}
OpenClaw behandelt die verouderde vorm als de afbeeldingsworkflowconfiguratie. Je hoeft niet onmiddellijk te migreren, maar de geneste secties image / video / music worden aanbevolen voor nieuwe setups.
Als je alleen afbeeldingsgeneratie gebruikt, zijn de verouderde platte configuratie en de nieuwe geneste sectie image functioneel gelijkwaardig.
Opt-in live dekking bestaat voor de gebundelde plugin:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
De live test slaat afzonderlijke afbeeldings-, video- of muziekgevallen over tenzij de overeenkomende Comfy-workflowsectie is geconfigureerd.

​
Gerelateerd

Afbeeldingen genereren

Configuratie en gebruik van de tool voor het genereren van afbeeldingen.

Video's genereren

Configuratie en gebruik van de tool voor het genereren van video’s.

Muziek genereren

Instelling van de tool voor het genereren van muziek en audio.

Provideroverzicht

Overzicht van alle providers en modelreferenties.

Configuratiereferentie

Volledige configuratiereferentie inclusief standaardwaarden voor agents.