Ana içeriğe atla

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, iş akışı tabanlı ComfyUI çalıştırmaları için paketlenmiş bir comfy Plugin’i ile gelir. Plugin tamamen iş akışı odaklıdır; bu nedenle OpenClaw genel size, aspectRatio, resolution, durationSeconds veya TTS tarzı denetimleri grafiğinize eşlemeye çalışmaz.
ÖzellikAyrıntı
Sağlayıcıcomfy
Modellercomfy/workflow
Paylaşılan yüzeylerimage_generate, video_generate, music_generate
Kimlik doğrulamaYerel ComfyUI için yok; Comfy Cloud için COMFY_API_KEY veya COMFY_CLOUD_API_KEY
APIComfyUI /prompt / /history / /view ve Comfy Cloud /api/*

​
Destekledikleri

  • Bir iş akışı JSON’undan görsel üretimi
  • 1 yüklenmiş referans görselle görsel düzenleme
  • Bir iş akışı JSON’undan video üretimi
  • 1 yüklenmiş referans görselle video üretimi
  • Paylaşılan music_generate aracı üzerinden müzik veya ses üretimi
  • Yapılandırılmış bir node’dan veya eşleşen tüm çıktı node’larından çıktı indirme

​
Başlarken

ComfyUI’ı kendi makinenizde çalıştırma veya Comfy Cloud kullanma arasında seçim yapın.
En iyisi: Kendi ComfyUI örneğinizi makinenizde veya LAN üzerinde çalıştırmak.
1

ComfyUI'ı yerelde başlatın

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

İş akışı JSON'unuzu hazırlayın

Bir ComfyUI iş akışı JSON dosyasını dışa aktarın veya oluşturun. Prompt girdi node’u ile OpenClaw’ın okuyacağı çıktı node’u için node kimliklerini not edin.
3

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

mode: "local" ayarlayın ve iş akışı dosyanıza işaret edin. Burada en düşük bir görsel örneği bulunuyor:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          mode: "local",
          baseUrl: "http://127.0.0.1:8188",
          image: {
            workflowPath: "./workflows/flux-api.json",
            promptNodeId: "6",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
4

Varsayılan modeli ayarlayın

OpenClaw’ı, yapılandırdığınız yetenek için comfy/workflow modeline yönlendirin:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

Doğrulayın

openclaw models list --provider comfy

​
Yapılandırma

Comfy, paylaşılan üst düzey bağlantı ayarlarını ve 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

AnahtarTürAçıklama
mode"local" veya "cloud"Bağlantı modu.
baseUrlstringYerel için varsayılan http://127.0.0.1:8188, bulut için https://cloud.comfy.org.
apiKeystringİsteğe bağlı doğrudan anahtar; COMFY_API_KEY / COMFY_CLOUD_API_KEY env değişkenlerine alternatiftir.
allowPrivateNetworkbooleanCloud modunda özel/LAN baseUrl değerine izin verir.

​
Yetenek başına anahtarlar

Bu anahtarlar image, video veya music bölümleri içinde geçerlidir:
AnahtarGerekliVarsayılanAçıklama
workflow veya workflowPathEvet—ComfyUI iş akışı JSON dosyasının yolu.
promptNodeIdEvet—Metin prompt’unu alan node kimliği.
promptInputNameHayır"text"Prompt node’u üzerindeki girdi adı.
outputNodeIdHayır—Çıktının okunacağı node kimliği. Atlanırsa, eşleşen tüm çıktı node’ları kullanılır.
pollIntervalMsHayır—İş tamamlanması için milisaniye cinsinden yoklama aralığı.
timeoutMsHayır—İş akışı çalıştırması için milisaniye cinsinden zaman aşımı.
image ve video bölümleri ayrıca şunları da destekler:
AnahtarGerekliVarsayılanAçıklama
inputImageNodeIdEvet (referans görsel geçirilirken)—Yüklenmiş referans görseli alan node kimliği.
inputImageInputNameHayır"image"Görsel node’u üzerindeki girdi adı.

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

Varsayılan görsel modelini comfy/workflow olarak ayarlayın:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Referans görsel düzenleme örneği:Yüklenmiş bir referans görselle görsel düzenlemeyi etkinleştirmek için görsel config’inize inputImageNodeId ekleyin:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          image: {
            workflowPath: "./workflows/edit-api.json",
            promptNodeId: "6",
            inputImageNodeId: "7",
            inputImageInputName: "image",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
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örselden videoya desteği sunar.
OpenClaw, giriş videolarını Comfy iş akışlarına geçirmez. Girdi olarak yalnızca metin prompt’ları ve tekil referans görseller desteklenir.
Paketlenmiş Plugin, iş akışıyla tanımlanan ses veya müzik çıktıları için shared music_generate aracı üzerinden sunulan bir müzik üretim sağlayıcısı kaydeder:
/tool music_generate prompt="Sıcak ambient synth loop, yumuşak tape dokulu"
Ses iş akışı JSON’unuza ve çıktı node’unuza işaret etmek için music config bölümünü kullanın.
Mevcut üst düzey görsel config’i (image iç içe bölümü olmadan) hâlâ çalışır:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}
OpenClaw, bu eski biçimi görsel iş akışı config’i olarak ele alır. Hemen taşımanız gerekmez, ancak yeni kurulumlar için iç içe image / video / music bölümleri önerilir.
Yalnızca görsel üretimi kullanıyorsanız, eski düz config ile yeni iç içe image bölümü işlevsel olarak eşdeğerdir.
Paketlenmiş Plugin için isteğe bağlı canlı kapsama 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ılmamışsa canlı test, tek tek görsel, video veya müzik vakalarını atlar.

​
İlgili

Görsel Üretimi

Görsel üretim aracı yapılandırması ve kullanımı.

Video Üretimi

Video üretim aracı yapılandırması ve kullanımı.

Müzik Üretimi

Müzik ve ses üretim aracı kurulumu.

Sağlayıcı Dizini

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

Yapılandırma başvurusu

Aracı varsayılanları dâhil tam yapılandırma başvurusu.