Providers

ComfyUI

OpenClaw enthält ein gebündeltes comfy Plugin für workflowgesteuerte ComfyUI-Ausführungen. Das Plugin ist vollständig workflowgesteuert, daher versucht OpenClaw nicht, generische Steuerelemente wie size, aspectRatio, resolution, durationSeconds oder TTS-ähnliche Optionen auf Ihren Graphen abzubilden.

Eigenschaft	Detail
Anbieter	`comfy`
Modelle	`comfy/workflow`
Gemeinsame Oberflächen	`image_generate`, `video_generate`, `music_generate`
Authentifizierung	Keine für lokales ComfyUI; `COMFY_API_KEY` oder `COMFY_CLOUD_API_KEY` für Comfy Cloud
API	ComfyUI `/prompt` / `/history` / `/view` und Comfy Cloud `/api/*`

Was unterstützt wird

Bildgenerierung aus einer Workflow-JSON
Bildbearbeitung mit 1 hochgeladenen Referenzbild
Videogenerierung aus einer Workflow-JSON
Videogenerierung mit 1 hochgeladenen Referenzbild
Musik- oder Audiogenerierung über das gemeinsame Tool music_generate
Herunterladen der Ausgabe von einem konfigurierten Node oder von allen passenden Ausgabe-Nodes

Erste Schritte

Wählen Sie zwischen dem Ausführen von ComfyUI auf Ihrem eigenen Rechner oder der Nutzung von Comfy Cloud.

Local

Am besten geeignet für: das Ausführen Ihrer eigenen ComfyUI-Instanz auf Ihrem Rechner oder im LAN.

Start ComfyUI locally

Stellen Sie sicher, dass Ihre lokale ComfyUI-Instanz läuft (standardmäßig unter http://127.0.0.1:8188).

Prepare your workflow JSON

Exportieren oder erstellen Sie eine ComfyUI-Workflow-JSON-Datei. Notieren Sie die Node-IDs für den Node zur Prompt-Eingabe und den Ausgabe-Node, aus dem OpenClaw lesen soll.

Configure the provider

Setzen Sie mode: "local" und verweisen Sie auf Ihre Workflow-Datei. Hier ist ein minimales Bildbeispiel:

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

Set the default model

Verweisen Sie OpenClaw für die konfigurierte Fähigkeit auf das Modell comfy/workflow:

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

Verify

openclaw models list --provider comfy

Comfy Cloud

Am besten geeignet für: das Ausführen von Workflows in Comfy Cloud, ohne lokale GPU-Ressourcen verwalten zu müssen.

Get an API key

Registrieren Sie sich unter comfy.org und generieren Sie einen API-Schlüssel in Ihrem Kontodashboard.

Set the API key

Stellen Sie Ihren Schlüssel mit einer der folgenden Methoden bereit:

# Umgebungsvariable (bevorzugt)
export COMFY_API_KEY="your-key"

# Alternative Umgebungsvariable
export COMFY_CLOUD_API_KEY="your-key"

# Oder direkt in der Konfiguration
openclaw config set plugins.entries.comfy.config.apiKey "your-key"

Prepare your workflow JSON

Exportieren oder erstellen Sie eine ComfyUI-Workflow-JSON-Datei. Notieren Sie die Node-IDs für den Node zur Prompt-Eingabe und den Ausgabe-Node.

Configure the provider

Setzen Sie mode: "cloud" und verweisen Sie auf Ihre Workflow-Datei:

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

Set the default model

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

Verify

openclaw models list --provider comfy

Konfiguration

Comfy unterstützt gemeinsame Verbindungseinstellungen auf oberster Ebene sowie workflowbezogene Abschnitte pro Fähigkeit (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",
          },
        },
      },
    },
  },
}

Gemeinsame Schlüssel

Schlüssel	Typ	Beschreibung
`mode`	`"local"` oder `"cloud"`	Verbindungsmodus.
`baseUrl`	string	Standard ist `http://127.0.0.1:8188` für lokal oder `https://cloud.comfy.org` für Cloud.
`apiKey`	string	Optionaler Inline-Schlüssel als Alternative zu den Umgebungsvariablen `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY`.
`allowPrivateNetwork`	boolean	Erlaubt eine private/LAN-`baseUrl` im Cloud-Modus.

Schlüssel pro Fähigkeit

Diese Schlüssel gelten innerhalb der Abschnitte image, video oder music:

Schlüssel	Erforderlich	Standard	Beschreibung
`workflow` oder `workflowPath`	Ja	--	Pfad zur ComfyUI-Workflow-JSON-Datei.
`promptNodeId`	Ja	--	Node-ID, die den Text-Prompt empfängt.
`promptInputName`	Nein	`"text"`	Eingabename auf dem Prompt-Node.
`outputNodeId`	Nein	--	Node-ID, aus der die Ausgabe gelesen wird. Wenn weggelassen, werden alle passenden Ausgabe-Nodes verwendet.
`pollIntervalMs`	Nein	--	Abfrageintervall in Millisekunden für den Abschluss des Jobs.
`timeoutMs`	Nein	--	Timeout in Millisekunden für die Workflow-Ausführung.

Die Abschnitte image und video unterstützen außerdem:

Schlüssel	Erforderlich	Standard	Beschreibung
`inputImageNodeId`	Ja (beim Übergeben eines Referenzbilds)	--	Node-ID, die das hochgeladene Referenzbild empfängt.
`inputImageInputName`	Nein	`"image"`	Eingabename auf dem Bild-Node.

Workflow-Details

Image workflows

Setzen Sie das Standardmodell für Bilder auf comfy/workflow:

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

Beispiel für die Bearbeitung mit Referenzbild:

Um die Bildbearbeitung mit einem hochgeladenen Referenzbild zu aktivieren, fügen Sie inputImageNodeId zu Ihrer Bildkonfiguration hinzu:

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

Video workflows

Setzen Sie das Standardmodell für Videos auf comfy/workflow:

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

Comfy-Video-Workflows unterstützen Text-zu-Video und Bild-zu-Video über den konfigurierten Graphen.

Music workflows

Das gebündelte Plugin registriert einen Anbieter für Musikgenerierung für workflowdefinierte Audio- oder Musikausgaben, bereitgestellt über das gemeinsame Tool music_generate:

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

Verwenden Sie den Konfigurationsabschnitt music, um auf Ihre Audio-Workflow-JSON und den Ausgabe-Node zu verweisen.

Backward compatibility

Die bestehende Bildkonfiguration auf oberster Ebene (ohne den verschachtelten Abschnitt image) funktioniert weiterhin:

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

OpenClaw behandelt diese ältere Form als Konfiguration für den Bild-Workflow. Sie müssen nicht sofort migrieren, aber die verschachtelten Abschnitte image / video / music werden für neue Setups empfohlen.

Live tests

Es gibt eine opt-in Live-Abdeckung für das gebündelte Plugin:

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

Der Live-Test überspringt einzelne Fälle für Bild, Video oder Musik, sofern der passende Comfy-Workflow-Abschnitt nicht konfiguriert ist.

Verwandt

Bildgenerierung

Konfiguration und Verwendung des Tools für die Bildgenerierung.

Videogenerierung

Konfiguration und Verwendung des Tools für die Videogenerierung.

Musikgenerierung

Einrichtung des Tools für Musik- und Audiogenerierung.

Anbieterverzeichnis

Überblick über alle Anbieter und Modellreferenzen.

Konfigurationsreferenz

Vollständige Konfigurationsreferenz einschließlich der Standardwerte für Agents.

# Was unterstützt wird

# Erste Schritte

Local

Start ComfyUI locally

Prepare your workflow JSON

Configure the provider

Set the default model

Verify

Comfy Cloud

Get an API key

Set the API key

Prepare your workflow JSON

Configure the provider

Set the default model

Verify

# Konfiguration

# Gemeinsame Schlüssel

# Schlüssel pro Fähigkeit

# Workflow-Details

# Verwandt

Was unterstützt wird

Erste Schritte

Konfiguration

Gemeinsame Schlüssel

Schlüssel pro Fähigkeit

Workflow-Details

Verwandt