Providers
ComfyUI
OpenClaw, iş akışı odaklı ComfyUI çalıştırmaları için paketle birlikte gelen bir comfy Plugin'i sunar. 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 yoktur; 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'undan görüntü oluşturma ve düzenleme (düzenleme için yüklenmiş 1 referans görüntü gerekir)
- Bir iş akışı JSON'undan 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_generatearacı üzerinden müzik/ses oluşturma - Yapılandırılmış bir Node'dan veya herhangi bir Node yapılandırılmamışsa eşleşen tüm çıktı Node'larından çıktıyı indirme
Başlarken
ComfyUI'yi kendi makinenizde çalıştırmak ile Comfy Cloud'u kullanmak arasında seçim yapın.
Yerel
Şunlar için idealdir: 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 adres http://127.0.0.1:8188).
İş akışı JSON'unuzu 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ğı çıktı 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. Asgari 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 comfyComfy Cloud
Şunlar için idealdir: yerel GPU kaynaklarını yönetmeden Comfy Cloud üzerinde iş akışları çalıştırmak.
Bir API anahtarı alın
comfy.org üzerinden kaydolun ve hesap panonuzdan bir API anahtarı oluşturun.
API anahtarını ayarlayın
Anahtarınızı şu yöntemlerden biriyle sağlayın:
# Onboarding flagopenclaw onboard --comfy-api-key "your-key" # Environment variable (preferred for daemons)export COMFY_API_KEY="your-key" # Alternative environment variableexport COMFY_CLOUD_API_KEY="your-key" # Or inline in configopenclaw config set plugins.entries.comfy.config.apiKey "your-key"İş akışı JSON'unuzu hazırlayın
Bir ComfyUI iş akışı JSON dosyasını dışa aktarın veya oluşturun. İstem girişi Node'u ile çıktı 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", }, }, }, }, },}Varsayılan modeli ayarlayın
{ agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, },}Doğrulayın
openclaw models list --provider comfyYapı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 değer "local"dır. |
baseUrl |
dize | Yerel mod için varsayılan değer http://127.0.0.1:8188, bulut modu için https://cloud.comfy.org değeridir. |
apiKey |
dize | İsteğe bağlı satır içi anahtar; COMFY_API_KEY / COMFY_CLOUD_API_KEY ortam değişkenlerine alternatiftir. |
allowPrivateNetwork |
boole | Bulut modunda özel/LAN baseUrl adresine veya yerel bir ö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'u 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. Belirtilmezse eşleşen tüm çıktı 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ü girişi Node'unu destekler:
| Anahtar | Gerekli | Varsayılan | Açıklama |
|---|---|---|---|
inputImageNodeId |
Evet (referans görüntü aktarılırken) | -- | Yüklenen referans görüntüyü 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üyle düzenleme örneği:
Yüklenmiş bir referans görüntü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.
Müzik iş akışları
Paketle birlikte gelen Plugin, iş akışıyla tanımlanan ses veya müzik çıktıları için bir müzik oluşturma sağlayıcısı kaydeder ve bunu paylaşılan music_generate aracı üzerinden sunar. İsteğe bağlı bir referans görüntüyü kabul eder (en fazla 1):
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"Ses iş akışı JSON'unuzu ve çıktı Node'unuzu 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şturmayı 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 gelen Plugin için isteğe bağlı canlı test kapsamı mevcuttur:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.tsCanlı test, eşleşen Comfy iş akışı bölümü yapılandırılmadığı sürece ayrı ayrı görüntü, video veya müzik durumlarını atlar.
İlgili
Görüntü oluşturma aracı yapılandırması ve kullanımı.
Video oluşturma aracı yapılandırması ve kullanımı.
Müzik ve ses oluşturma aracı kurulumu.
Tüm sağlayıcılara ve model referanslarına genel bakış.
Ajan varsayılanları dâhil eksiksiz yapılandırma referansı.
