Ana içeriğe atla

ComfyUI

OpenClaw, iş akışı odaklı ComfyUI çalıştırmaları için paketlenmiş bir comfy plugin’i ile gelir.
  • Sağlayıcı: comfy
  • Modeller: comfy/workflow
  • Paylaşılan yüzeyler: 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 ve Comfy Cloud /api/*

Neleri destekler

  • Bir iş akışı JSON dosyasından görsel oluşturma
  • Yüklenmiş 1 referans görselle görsel düzenleme
  • Bir iş akışı JSON dosyasından video oluşturma
  • Yüklenmiş 1 referans görselle video oluşturma
  • Paylaşılan music_generate aracı üzerinden müzik veya ses oluşturma
  • Yapılandırılmış bir düğümden veya eşleşen tüm çıktı düğümlerinden çıktı indirme
Paketlenmiş plugin iş akışı odaklıdır, bu nedenle OpenClaw genel size, aspectRatio, resolution, durationSeconds veya TTS tarzı denetimleri grafiğinize eşlemeye çalışmaz.

Yapılandırma düzeni

Comfy, paylaşılan üst düzey bağlantı ayarlarını ve yetenek başına iş akışı bölümlerini destekler:
{
  models: {
    providers: {
      comfy: {
        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:
  • mode: local veya cloud
  • baseUrl: yerel için varsayılan http://127.0.0.1:8188, cloud için https://cloud.comfy.org
  • apiKey: ortam değişkenlerine isteğe bağlı satır içi anahtar alternatifi
  • allowPrivateNetwork: cloud kipinde özel/LAN baseUrl değerine izin verir
image, video veya music altındaki yetenek başına anahtarlar:
  • workflow veya workflowPath: zorunlu
  • promptNodeId: zorunlu
  • promptInputName: varsayılan text
  • outputNodeId: isteğe bağlı
  • pollIntervalMs: isteğe bağlı
  • timeoutMs: isteğe bağlı
Görsel ve video bölümleri ayrıca şunları da destekler:
  • inputImageNodeId: referans görsel geçirdiğinizde zorunlu
  • inputImageInputName: varsayılan image

Geriye dönük uyumluluk

Mevcut üst düzey görsel yapılandırması hâlâ çalışır:
{
  models: {
    providers: {
      comfy: {
        workflowPath: "./workflows/flux-api.json",
        promptNodeId: "6",
        outputNodeId: "9",
      },
    },
  },
}
OpenClaw bu eski biçimi görsel iş akışı yapılandırması olarak ele alır.

Görsel iş akışları

Varsayılan görsel modelini ayarlayın:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Referans görselli düzenleme örneği:
{
  models: {
    providers: {
      comfy: {
        image: {
          workflowPath: "./workflows/edit-api.json",
          promptNodeId: "6",
          inputImageNodeId: "7",
          inputImageInputName: "image",
          outputNodeId: "9",
        },
      },
    },
  },
}

Video iş akışları

Varsayılan video modelini ayarlayın:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Comfy video iş akışları şu anda 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.

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ı kaydeder:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
Ses iş akışı JSON dosyanıza ve çıktı düğümüne işaret etmek için music yapılandırma bölümünü kullanın.

Comfy Cloud

mode: "cloud" ile birlikte aşağıdakilerden birini kullanın:
  • COMFY_API_KEY
  • COMFY_CLOUD_API_KEY
  • models.providers.comfy.apiKey
Cloud kipi hâlâ aynı image, video ve music iş akışı bölümlerini kullanır.

Canlı testler

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
Canlı test, eşleşen Comfy iş akışı bölümü yapılandırılmadıkça tek tek görsel, video veya müzik durumlarını atlar.

İlgili