OpenClawDocs
Na tej stronie

Na tej stronie

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

Providers

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

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:

    json5
    {  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:

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

  • Verify

    bash
    openclaw models list --provider comfy

    • Comfy Cloud

    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:

    bash
    # Flaga wdrażaniaopenclaw onboard --comfy-api-key "your-key" # Zmienna środowiskowa (preferowana dla demonów)export COMFY_API_KEY="your-key" # Alternatywna zmienna środowiskowaexport COMFY_CLOUD_API_KEY="your-key" # Lub bezpośrednio w konfiguracjiopenclaw 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:

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

  • Set the default model

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

  • Verify

    bash
    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):

    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",          },        },      },    },  },}

    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.

    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:

    json5
    {  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:

    json5
    {  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:

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

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

    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):

    text
    /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:

    json5
    {  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:

    bash
    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.
    Was this useful?