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

Providers

ComfyUI

OpenClaw, iş akışı odaklı ComfyUI çalıştırmaları için paketlenmiş bir comfy plugin ile birlikte gelir. Bu plugin tamamen iş akışı odaklıdır: OpenClaw genel size, aspectRatio, resolution, durationSeconds veya TTS tarzı denetimleri grafiğinizle eşleştirmez.

Özellik Ayrıntı
Sağlayıcı comfy
Model comfy/workflow
Paylaşılan araçlar image_generate, video_generate, music_generate
Kimlik doğrulama Yerel ComfyUI için yok; Comfy Cloud için COMFY_API_KEY veya COMFY_CLOUD_API_KEY
API ComfyUI /prompt / /history / /view; Comfy Cloud /api/*

Desteklenenler

  • Bir iş akışı JSON'ından görüntü oluşturma ve düzenleme (düzenleme için yüklenmiş 1 referans görüntü gerekir)
  • Bir iş akışı JSON'ından metinden videoya veya görüntüden videoya video oluşturma (1 referans görüntü)
  • İsteğe bağlı 1 referans görüntüyle, paylaşılan music_generate aracı üzerinden müzik/ses oluşturma
  • Yapılandırılmış bir Node'dan veya hiçbir Node yapılandırılmamışsa eşleşen tüm çıkış Node'larından çıktıyı indirme

Başlarken

ComfyUI'yi kendi makinenizde çalıştırmakla Comfy Cloud'u kullanmak arasında seçim yapın.

Yerel

En uygun kullanım: kendi ComfyUI örneğinizi makinenizde veya LAN'ınızda çalıştırmak.

  • ComfyUI'yi yerel olarak başlatın

    Yerel ComfyUI örneğinizin çalıştığından emin olun (varsayılan: http://127.0.0.1:8188).

  • İş akışı JSON'ınızı hazırlayın

    Bir ComfyUI iş akışı JSON dosyasını dışa aktarın veya oluşturun. İstem girişi Node'u ile OpenClaw'un okuyacağı çıkış Node'unun kimliklerini not edin.

  • Sağlayıcıyı yapılandırın

    mode: "local" değerini ayarlayın ve iş akışı dosyanızı belirtin. Minimal görüntü örneği:

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

  • Varsayılan modeli ayarlayın

    OpenClaw'u yapılandırdığınız yetenek için comfy/workflow modeline yönlendirin:

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

  • Doğrulayın

    bash
    openclaw models list --provider comfy

    • Comfy Cloud

    En uygun kullanım: yerel GPU kaynaklarını yönetmeden Comfy Cloud'da iş akışları çalıştırmak.

  • Bir API anahtarı alın

    comfy.org adresinden kaydolun ve hesap panonuzdan bir API anahtarı oluşturun.

  • API anahtarını ayarlayın

    Anahtarınızı şu yöntemlerden herhangi biriyle sağlayın:

    bash
    # İlk kurulum bayrağıopenclaw onboard --comfy-api-key "your-key" # Ortam değişkeni (daemon'lar için tercih edilir)export COMFY_API_KEY="your-key" # Alternatif ortam değişkeniexport COMFY_CLOUD_API_KEY="your-key" # Veya doğrudan yapılandırmadaopenclaw config set plugins.entries.comfy.config.apiKey "your-key"

  • İş akışı JSON'ınızı hazırlayın

    Bir ComfyUI iş akışı JSON dosyasını dışa aktarın veya oluşturun. İstem girişi Node'u ile çıkış Node'unun kimliklerini not edin.

  • Sağlayıcıyı yapılandırın

    mode: "cloud" değerini ayarlayın ve iş akışı dosyanızı belirtin:

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

  • Varsayılan modeli ayarlayın

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

  • Doğrulayın

    bash
    openclaw models list --provider comfy

    • Yapılandırma

    Comfy, paylaşılan üst düzey bağlantı ayarlarının yanı sıra yetenek başına iş akışı bölümlerini (image, video, music) destekler:

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

    Paylaşılan anahtarlar

    Anahtar Tür Açıklama
    mode "local" veya "cloud" Bağlantı modu. Varsayılan: "local".
    baseUrl dize Yerel için varsayılan http://127.0.0.1:8188, bulut için https://cloud.comfy.org.
    apiKey dize İsteğe bağlı satır içi anahtar; COMFY_API_KEY / COMFY_CLOUD_API_KEY ortam değişkenlerine alternatiftir.
    allowPrivateNetwork boolean Bulut modunda özel/LAN baseUrl veya yerel özel DNS FQDN'sine izin verir.

    Yetenek başına anahtarlar

    Bu anahtarlar image, video veya music bölümlerinde geçerlidir:

    Anahtar Gerekli Varsayılan Açıklama
    workflow veya workflowPath Evet -- Satır içi iş akışı JSON'ı veya ComfyUI iş akışı JSON dosyasının yolu.
    promptNodeId Evet -- Metin istemini alan Node kimliği.
    promptInputName Hayır "text" İstem Node'undaki giriş adı.
    outputNodeId Hayır -- Çıktının okunacağı Node kimliği. Atlanırsa eşleşen tüm çıkış Node'ları kullanılır.
    pollIntervalMs Hayır 1500 İşin tamamlanması için milisaniye cinsinden yoklama aralığı.
    timeoutMs Hayır 300000 İş akışı çalıştırması için milisaniye cinsinden zaman aşımı.

    image ve video bölümleri ayrıca bir referans görüntüsü giriş Node'unu destekler:

    Anahtar Gerekli Varsayılan Açıklama
    inputImageNodeId Evet (referans görüntüsü aktarılırken) -- Yüklenen referans görüntüsünü alan Node kimliği.
    inputImageInputName Hayır "image" Görüntü Node'undaki giriş adı.

    apiKey, değişmez bir dizeyi veya bir gizli bilgi referansı nesnesini kabul eder.

    İş akışı ayrıntıları

    Görüntü iş akışları

    Varsayılan görüntü modelini comfy/workflow olarak ayarlayın:

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

    Referans görüntüsü düzenleme örneği:

    Yüklenmiş bir referans görüntüsüyle görüntü düzenlemeyi etkinleştirmek için görüntü yapılandırmanıza inputImageNodeId ekleyin:

    json5
    {  plugins: {    entries: {      comfy: {        config: {          image: {            workflowPath: "./workflows/edit-api.json",            promptNodeId: "6",            inputImageNodeId: "7",            inputImageInputName: "image",            outputNodeId: "9",          },        },      },    },  },}
    Video iş akışları

    Varsayılan video modelini comfy/workflow olarak ayarlayın:

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

    Comfy video iş akışları, yapılandırılmış grafik üzerinden metinden videoya ve görüntüden videoya oluşturmayı destekler.

    Müzik iş akışları

    Paketlenmiş plugin, iş akışıyla tanımlanmış ses veya müzik çıktıları için paylaşılan music_generate aracı üzerinden sunulan bir müzik oluşturma sağlayıcısını kaydeder. İsteğe bağlı bir referans görüntüsü kabul eder (en fazla 1):

    text
    /tool music_generate prompt="Yumuşak bant dokulu sıcak ambiyanslı synth döngüsü"

    Ses iş akışı JSON'ınızı ve çıkış Node'unu belirtmek için music yapılandırma bölümünü kullanın.

    Geriye dönük uyumluluk

    Mevcut üst düzey görüntü yapılandırması (iç içe image bölümü olmadan) çalışmaya devam eder:

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

    OpenClaw, bu eski biçimi görüntü iş akışı yapılandırması olarak değerlendirir. Hemen geçiş yapmanız gerekmez, ancak yeni kurulumlar için iç içe image / video / music bölümleri önerilir. Yalnızca görüntü oluşturma kullanıyorsanız eski düz yapılandırma ile yeni iç içe image bölümü işlevsel olarak eşdeğerdir.

    Canlı testler

    Paketle birlikte sunulan Plugin için isteğe bağlı canlı kapsam mevcuttur:

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

    Eşleşen Comfy iş akışı bölümü yapılandırılmadığı sürece canlı test, ayrı görüntü, video veya müzik durumlarını atlar.

    İlgili

    Görüntü Oluşturma

    Görüntü oluşturma aracı yapılandırması ve kullanımı.
    Video Oluşturma

    Video oluşturma aracı yapılandırması ve kullanımı.
    Müzik Oluşturma

    Müzik ve ses oluşturma aracı kurulumu.
    Sağlayıcı Dizini

    Tüm sağlayıcılara ve model referanslarına genel bakış.
    Yapılandırma referansı

    Aracı varsayılanları dâhil tam yapılandırma referansı.
    Was this useful?
    On this page

    On this page