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:
{ 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 comfyComfy 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:
# 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:
{ 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 comfyKonfiguracja
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. |
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.
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.tsTest 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
Konfiguracja i użycie narzędzia do generowania obrazów.
Konfiguracja i użycie narzędzia do generowania filmów.
Konfiguracja narzędzia do generowania muzyki i dźwięku.
Przegląd wszystkich dostawców i odwołań do modeli.
Pełna dokumentacja konfiguracji, w tym ustawień domyślnych agentów.
