ComfyUI

OpenClaw zawiera wbudowany plugin comfy do uruchamiania ComfyUI sterowanego przepływami pracy. Plugin jest w pełni sterowany przepływem pracy: OpenClaw nie odwzorowuje ogólnych parametrów size, aspectRatio, resolution, durationSeconds ani kontrolek typowych dla TTS na graf użytkownika.

Właściwość	Szczegóły
Dostawca	`comfy`
Model	`comfy/workflow`
Narzędzia wspólne	`image_generate`, `video_generate`, `music_generate`
Uwierzytelnianie	Brak dla lokalnego ComfyUI; `COMFY_API_KEY` lub `COMFY_CLOUD_API_KEY` dla Comfy Cloud
API	ComfyUI `/prompt` / `/history` / `/view`; Comfy Cloud `/api/*`

Obsługiwane funkcje

Generowanie i edycja obrazów na podstawie przepływu pracy JSON (edycja przyjmuje 1 przesłany obraz referencyjny)
Generowanie wideo na podstawie przepływu pracy JSON, z tekstu lub obrazu (1 obraz referencyjny)
Generowanie muzyki/dźwięku za pomocą wspólnego narzędzia music_generate, opcjonalnie z 1 obrazem referencyjnym
Pobieranie wyniku ze skonfigurowanego Node lub ze wszystkich pasujących wyjściowych Node, gdy żaden nie został skonfigurowany

Pierwsze kroki

Wybierz między uruchamianiem ComfyUI na własnym komputerze a korzystaniem z Comfy Cloud.

Local
Comfy Cloud

Najlepsze zastosowanie: uruchamianie własnej instancji ComfyUI na komputerze lub w sieci LAN.

Start ComfyUI locally

Upewnij się, że lokalna instancja ComfyUI jest uruchomiona (domyślnie pod adresem http://127.0.0.1:8188).

Prepare your workflow JSON

Wyeksportuj lub utwórz plik JSON przepływu pracy ComfyUI. Zanotuj identyfikatory Node wejścia promptu oraz wyjściowego Node, z którego OpenClaw ma odczytywać dane.

Configure the provider

Ustaw mode: "local" i wskaż plik przepływu pracy. Minimalny przykład dla obrazu:

{
  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

Skieruj OpenClaw do modelu comfy/workflow dla skonfigurowanej możliwości:

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

Verify

openclaw models list --provider comfy

Najlepsze zastosowanie: uruchamianie przepływów pracy w Comfy Cloud bez zarządzania lokalnymi zasobami GPU.

Get an API key

Zarejestruj się w serwisie comfy.org i wygeneruj klucz API w panelu swojego konta.

Set the API key

Podaj klucz jedną z poniższych metod:

# Flaga wdrażania
openclaw onboard --comfy-api-key "your-key"

# Zmienna środowiskowa (preferowana dla demonów)
export COMFY_API_KEY="your-key"

# Alternatywna zmienna środowiskowa
export COMFY_CLOUD_API_KEY="your-key"

# Lub bezpośrednio w konfiguracji
openclaw config set plugins.entries.comfy.config.apiKey "your-key"

Prepare your workflow JSON

Wyeksportuj lub utwórz plik JSON przepływu pracy ComfyUI. Zanotuj identyfikatory Node wejścia promptu oraz wyjściowego Node.

Configure the provider

Ustaw mode: "cloud" i wskaż plik przepływu pracy:

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

W trybie chmurowym baseUrl ma domyślnie wartość https://cloud.comfy.org. Ustaw baseUrl tylko dla niestandardowego punktu końcowego w chmurze.

Set the default model

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

Verify

openclaw models list --provider comfy

Konfiguracja

Comfy obsługuje wspólne ustawienia połączenia najwyższego poziomu oraz sekcje przepływu pracy dla poszczególnych możliwości (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",
          },
        },
      },
    },
  },
}

Klucze wspólne

Klucz	Typ	Opis
`mode`	`"local"` lub `"cloud"`	Tryb połączenia. Wartość domyślna to `"local"`.
`baseUrl`	ciąg znaków	Wartość domyślna to `http://127.0.0.1:8188` lokalnie lub `https://cloud.comfy.org` w chmurze.
`apiKey`	ciąg znaków	Opcjonalny klucz podany bezpośrednio, stanowiący alternatywę dla zmiennych środowiskowych `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY`.
`allowPrivateNetwork`	wartość logiczna	Zezwala na prywatny/sieciowy `baseUrl` w trybie chmurowym lub lokalną nazwę FQDN w prywatnym DNS.

W trybie local literały adresów IP local loopback/prywatnych oraz jednoczłonowe nazwy usług, takie jak http://comfyui:8188, działają bez allowPrivateNetwork. Wyglądające na publiczne nazwy FQDN w prywatnym DNS, takie jak https://comfy.local.example.com, wymagają allowPrivateNetwork: true. Zaufanie do prywatnego źródła pozostaje ograniczone do skonfigurowanego schematu, nazwy hosta i portu; lokalne przekierowania nie mogą opuścić skonfigurowanej nazwy hosta, natomiast przekierowania z chmury do publicznych sieci CDN są sprawdzane zgodnie z domyślnymi zasadami SSRF.

Klucze poszczególnych możliwości

Te klucze mają zastosowanie wewnątrz sekcji image, video lub music:

Klucz	Wymagany	Domyślnie	Opis
`workflow` lub `workflowPath`	Tak	—	Przepływ pracy JSON podany bezpośrednio lub ścieżka do pliku JSON przepływu pracy ComfyUI.
`promptNodeId`	Tak	—	Identyfikator Node, który otrzymuje prompt tekstowy.
`promptInputName`	Nie	`"text"`	Nazwa wejścia w Node promptu.
`outputNodeId`	Nie	—	Identyfikator Node, z którego odczytywany jest wynik. Jeśli go pominięto, używane są wszystkie pasujące wyjściowe Node.
`pollIntervalMs`	Nie	`1500`	Interwał odpytywania w milisekundach w oczekiwaniu na ukończenie zadania.
`timeoutMs`	Nie	`300000`	Limit czasu uruchomienia przepływu pracy w milisekundach.

Sekcje image i video obsługują również wejściowy Node obrazu referencyjnego:

Klucz	Wymagany	Domyślnie	Opis
`inputImageNodeId`	Tak (podczas przekazywania obrazu referencyjnego)	—	Identyfikator Node, który otrzymuje przesłany obraz referencyjny.
`inputImageInputName`	Nie	`"image"`	Nazwa wejścia w Node obrazu.

apiKey przyjmuje literał ciągu znaków albo obiekt odwołania do sekretu.

Szczegóły przepływu pracy

Image workflows

Ustaw domyślny model obrazu na comfy/workflow:

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

Przykład edycji z obrazem referencyjnym:Aby włączyć edycję obrazów przy użyciu przesłanego obrazu referencyjnego, dodaj inputImageNodeId do konfiguracji obrazu:

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

Video workflows

Ustaw domyślny model wideo na comfy/workflow:

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

Przepływy pracy wideo Comfy obsługują generowanie wideo z tekstu i obrazu za pośrednictwem skonfigurowanego grafu.

OpenClaw nie przekazuje wejściowych plików wideo do przepływów pracy Comfy. Jako dane wejściowe obsługiwane są wyłącznie prompty tekstowe i pojedyncze obrazy referencyjne.

Music workflows

Wbudowany plugin rejestruje dostawcę generowania muzyki dla wyników dźwiękowych lub muzycznych zdefiniowanych przez przepływ pracy, udostępnianego za pomocą wspólnego narzędzia music_generate. Przyjmuje ono opcjonalny obraz referencyjny (maksymalnie 1):

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

Użyj sekcji konfiguracji music, aby wskazać plik JSON przepływu pracy dźwięku oraz wyjściowy Node.

Backward compatibility

Istniejąca konfiguracja obrazu najwyższego poziomu (bez zagnieżdżonej sekcji image) nadal działa:

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

OpenClaw traktuje ten starszy kształt jako konfigurację przepływu pracy obrazu. Nie musisz przeprowadzać migracji natychmiast, ale zagnieżdżone sekcje image / video / music są zalecane dla nowych konfiguracji. Jeśli używasz wyłącznie generowania obrazów, starsza płaska konfiguracja i nowa zagnieżdżona sekcja image są funkcjonalnie równoważne.

Live tests

Dla wbudowanego pluginu dostępne są opcjonalne testy na żywo:

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

Test na żywo pomija poszczególne przypadki obrazów, filmów lub muzyki, chyba że skonfigurowano odpowiednią sekcję przepływu pracy Comfy.

Powiązane materiały

Generowanie obrazów

Konfiguracja i użycie narzędzia do generowania obrazów.

Generowanie filmów

Konfiguracja i użycie narzędzia do generowania filmów.

Generowanie muzyki

Konfiguracja narzędzia do generowania muzyki i dźwięku.

Katalog dostawców

Przegląd wszystkich dostawców i odwołań do modeli.

Dokumentacja konfiguracji

Pełna dokumentacja konfiguracji, w tym ustawień domyślnych agentów.

Overview

Concepts and configuration

Providers

Obsługiwane funkcje

Pierwsze kroki

Konfiguracja

Klucze wspólne

Klucze poszczególnych możliwości

Szczegóły przepływu pracy

Powiązane materiały

Generowanie obrazów

Generowanie filmów

Generowanie muzyki

Katalog dostawców

Dokumentacja konfiguracji

​Obsługiwane funkcje

​Pierwsze kroki

​Konfiguracja

​Klucze wspólne

​Klucze poszczególnych możliwości

​Szczegóły przepływu pracy

​Powiązane materiały

Generowanie obrazów

Generowanie filmów

Generowanie muzyki

Katalog dostawców

Dokumentacja konfiguracji

Obsługiwane funkcje

Pierwsze kroki

Konfiguracja

Klucze wspólne

Klucze poszczególnych możliwości

Szczegóły przepływu pracy

Powiązane materiały