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
Comfy Cloud

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:

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

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

Doğrulayın

openclaw models list --provider comfy

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:

# İ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şkeni
export COMFY_CLOUD_API_KEY="your-key"

# Veya doğrudan yapılandırmada
openclaw 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:

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

Bulut modu, baseUrl için varsayılan olarak https://cloud.comfy.org değerini kullanır. baseUrl değerini yalnızca özel bir bulut uç noktası için ayarlayın.

Varsayılan modeli ayarlayın

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

Doğrulayın

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:

{
  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.

local modunda, geri döngü/özel IP değişmez değerleri ve http://comfyui:8188 gibi tek etiketli hizmet adları allowPrivateNetwork olmadan çalışır. https://comfy.local.example.com gibi herkese açık görünen özel DNS FQDN’leri için allowPrivateNetwork: true gerekir. Özel kaynak güveni, yapılandırılmış şema, ana bilgisayar adı ve bağlantı noktasıyla sınırlı kalır; yerel yönlendirmeler yapılandırılmış ana bilgisayar adının dışına çıkamazken herkese açık CDN’lere yapılan bulut yönlendirmeleri varsayılan SSRF politikasıyla denetlenir.

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:

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

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

{
  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.

OpenClaw, giriş videolarını Comfy iş akışlarına aktarmaz. Giriş olarak yalnızca metin istemleri ve tek referans görüntüleri desteklenir.

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

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

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

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ı.

Overview

Concepts and configuration

Providers

Desteklenenler

Başlarken

Yapılandırma

Paylaşılan anahtarlar

Yetenek başına anahtarlar

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

İlgili

Görüntü Oluşturma

Video Oluşturma

Müzik Oluşturma

Sağlayıcı Dizini

Yapılandırma referansı

​Desteklenenler

​Başlarken

​Yapılandırma

​Paylaşılan anahtarlar

​Yetenek başına anahtarlar

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

​İlgili

Görüntü Oluşturma

Video Oluşturma

Müzik Oluşturma

Sağlayıcı Dizini

Yapılandırma referansı

Desteklenenler

Başlarken

Yapılandırma

Paylaşılan anahtarlar

Yetenek başına anahtarlar

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

İlgili