Przejdź do głównej treści

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 dostarcza wbudowany plugin comfy do uruchamiania ComfyUI sterowanego workflow. Plugin jest w pełni sterowany przez workflow, więc OpenClaw nie próbuje mapować ogólnych ustawień size, aspectRatio, resolution, durationSeconds ani kontrolek w stylu TTS na Twój graf.
WłaściwośćSzczegóły
Dostawcacomfy
Modelecomfy/workflow
Współdzielone powierzchnieimage_generate, video_generate, music_generate
AuthBrak dla lokalnego ComfyUI; COMFY_API_KEY lub COMFY_CLOUD_API_KEY dla Comfy Cloud
APIComfyUI /prompt / /history / /view oraz Comfy Cloud /api/*

​
Co jest obsługiwane

  • Generowanie obrazów z workflow JSON
  • Edycja obrazów z 1 przesłanym obrazem referencyjnym
  • Generowanie wideo z workflow JSON
  • Generowanie wideo z 1 przesłanym obrazem referencyjnym
  • Generowanie muzyki lub audio przez współdzielone narzędzie music_generate
  • Pobieranie wyjścia ze skonfigurowanego node albo ze wszystkich pasujących node wyjściowych

​
Pierwsze kroki

Wybierz między uruchamianiem ComfyUI na własnej maszynie a używaniem Comfy Cloud.
Najlepsze do: uruchamiania własnej instancji ComfyUI na swojej maszynie lub w sieci LAN.
1

Uruchom ComfyUI lokalnie

Upewnij się, że lokalna instancja ComfyUI działa (domyślnie pod http://127.0.0.1:8188).
2

Przygotuj workflow JSON

Wyeksportuj lub utwórz plik workflow JSON ComfyUI. Zanotuj identyfikatory node dla node wejścia promptu i node wyjścia, z którego OpenClaw ma odczytywać dane.
3

Skonfiguruj dostawcę

Ustaw mode: "local" i wskaż plik workflow. Oto 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",
          },
        },
      },
    },
  },
}
4

Ustaw model domyślny

Skieruj OpenClaw na model comfy/workflow dla skonfigurowanej capability:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

Zweryfikuj

openclaw models list --provider comfy

​
Konfiguracja

Comfy obsługuje współdzielone ustawienia połączenia najwyższego poziomu oraz sekcje workflow dla poszczególnych 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",
          },
        },
      },
    },
  },
}

​
Współdzielone klucze

KluczTypOpis
mode"local" or "cloud"Tryb połączenia.
baseUrlstringDomyślnie http://127.0.0.1:8188 lokalnie lub https://cloud.comfy.org w chmurze.
apiKeystringOpcjonalny klucz w konfiguracji, alternatywa dla zmiennych środowiskowych COMFY_API_KEY / COMFY_CLOUD_API_KEY.
allowPrivateNetworkbooleanZezwala na prywatny/LAN baseUrl w trybie cloud.

​
Klucze dla poszczególnych capability

Te klucze obowiązują w sekcjach image, video lub music:
KluczWymaganeDomyślnieOpis
workflow or workflowPathTak—Ścieżka do pliku workflow JSON ComfyUI.
promptNodeIdTak—Identyfikator node, który otrzymuje prompt tekstowy.
promptInputNameNie"text"Nazwa wejścia w node promptu.
outputNodeIdNie—Identyfikator node, z którego odczytywane jest wyjście. Jeśli pominięty, używane są wszystkie pasujące node wyjściowe.
pollIntervalMsNie—Interwał odpytywania w milisekundach dla zakończenia zadania.
timeoutMsNie—Limit czasu w milisekundach dla uruchomienia workflow.
Sekcje image i video obsługują także:
KluczWymaganeDomyślnieOpis
inputImageNodeIdTak (przy przekazywaniu obrazu referencyjnego)—Identyfikator node, który otrzymuje przesłany obraz referencyjny.
inputImageInputNameNie"image"Nazwa wejścia w node obrazu.

​
Szczegóły workflow

Ustaw domyślny model obrazu na comfy/workflow:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Przykład edycji z obrazem referencyjnym:Aby włączyć edycję obrazu z przesłanym obrazem referencyjnym, dodaj inputImageNodeId do konfiguracji obrazu:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          image: {
            workflowPath: "./workflows/edit-api.json",
            promptNodeId: "6",
            inputImageNodeId: "7",
            inputImageInputName: "image",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
Ustaw domyślny model wideo na comfy/workflow:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Workflow wideo Comfy obsługują text-to-video i image-to-video przez skonfigurowany graf.
OpenClaw nie przekazuje wejściowych plików wideo do workflow Comfy. Jako wejście obsługiwane są tylko prompty tekstowe i pojedyncze obrazy referencyjne.
Wbudowany plugin rejestruje dostawcę generowania muzyki dla wyjść audio lub muzyki zdefiniowanych przez workflow, udostępnianych przez współdzielone narzędzie music_generate:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
Użyj sekcji konfiguracji music, aby wskazać workflow JSON audio i node wyjścia.
Dotychczasowa 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ę workflow obrazu. Nie musisz migrować od razu, ale w nowych konfiguracjach zalecane są zagnieżdżone sekcje image / video / music.
Jeśli używasz tylko generowania obrazów, starsza płaska konfiguracja i nowa zagnieżdżona sekcja image są funkcjonalnie równoważne.
Dla wbudowanego pluginu istnieje opcjonalny zakres testów live:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
Test live pomija poszczególne przypadki obrazów, wideo lub muzyki, chyba że skonfigurowano odpowiadającą sekcję workflow Comfy.

​
Powiązane

Generowanie obrazów

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

Generowanie wideo

Konfiguracja i użycie narzędzia do generowania wideo.

Generowanie muzyki

Konfiguracja narzędzia do generowania muzyki i audio.

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.