Langsung ke konten utama

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 mengirim Plugin comfy bawaan untuk run ComfyUI berbasis alur kerja. Plugin ini sepenuhnya berbasis alur kerja, jadi OpenClaw tidak mencoba memetakan size, aspectRatio, resolution, durationSeconds, atau kontrol bergaya TTS generik ke graph Anda.
PropertiDetail
Providercomfy
Modelcomfy/workflow
Permukaan bersamaimage_generate, video_generate, music_generate
AuthTidak ada untuk ComfyUI lokal; COMFY_API_KEY atau COMFY_CLOUD_API_KEY untuk Comfy Cloud
APIComfyUI /prompt / /history / /view dan Comfy Cloud /api/*

​
Yang didukung

  • Pembuatan gambar dari JSON alur kerja
  • Pengeditan gambar dengan 1 gambar referensi yang diunggah
  • Pembuatan video dari JSON alur kerja
  • Pembuatan video dengan 1 gambar referensi yang diunggah
  • Pembuatan musik atau audio melalui tool music_generate bersama
  • Pengunduhan output dari node yang dikonfigurasi atau semua node output yang cocok

​
Memulai

Pilih antara menjalankan ComfyUI di mesin Anda sendiri atau menggunakan Comfy Cloud.
Terbaik untuk: menjalankan instance ComfyUI Anda sendiri di mesin atau LAN Anda.
1

Mulai ComfyUI secara lokal

Pastikan instance ComfyUI lokal Anda berjalan (default ke http://127.0.0.1:8188).
2

Siapkan JSON alur kerja Anda

Ekspor atau buat file JSON alur kerja ComfyUI. Catat ID node untuk node input prompt dan node output yang ingin dibaca OpenClaw.
3

Konfigurasikan provider

Atur mode: "local" dan arahkan ke file alur kerja Anda. Berikut contoh gambar minimal:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          mode: "local",
          baseUrl: "http://127.0.0.1:8188",
          image: {
            workflowPath: "./workflows/flux-api.json",
            promptNodeId: "6",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
4

Atur model default

Arahkan OpenClaw ke model comfy/workflow untuk capability yang Anda konfigurasi:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

Verifikasi

openclaw models list --provider comfy

​
Konfigurasi

Comfy mendukung pengaturan koneksi tingkat atas bersama plus bagian alur kerja per-capability (image, video, music): 
{
  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",
          },
        },
      },
    },
  },
}

​
Kunci bersama

KunciTipeDeskripsi
mode"local" atau "cloud"Mode koneksi.
baseUrlstringDefault ke http://127.0.0.1:8188 untuk lokal atau https://cloud.comfy.org untuk cloud.
apiKeystringKey inline opsional, alternatif dari env var COMFY_API_KEY / COMFY_CLOUD_API_KEY.
allowPrivateNetworkbooleanIzinkan baseUrl private/LAN dalam mode cloud.

​
Kunci per-capability

Kunci ini berlaku di dalam bagian image, video, atau music:
KunciWajibDefaultDeskripsi
workflow atau workflowPathYa—Path ke file JSON alur kerja ComfyUI.
promptNodeIdYa—ID node yang menerima prompt teks.
promptInputNameTidak"text"Nama input pada node prompt.
outputNodeIdTidak—ID node untuk membaca output. Jika dihilangkan, semua node output yang cocok digunakan.
pollIntervalMsTidak—Interval polling dalam milidetik untuk penyelesaian pekerjaan.
timeoutMsTidak—Timeout dalam milidetik untuk run alur kerja.
Bagian image dan video juga mendukung:
KunciWajibDefaultDeskripsi
inputImageNodeIdYa (saat meneruskan gambar referensi)—ID node yang menerima gambar referensi yang diunggah.
inputImageInputNameTidak"image"Nama input pada node gambar.

​
Detail alur kerja

Atur model gambar default ke comfy/workflow:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Contoh pengeditan gambar referensi:Untuk mengaktifkan pengeditan gambar dengan gambar referensi yang diunggah, tambahkan inputImageNodeId ke config gambar Anda:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          image: {
            workflowPath: "./workflows/edit-api.json",
            promptNodeId: "6",
            inputImageNodeId: "7",
            inputImageInputName: "image",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
Atur model video default ke comfy/workflow:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Alur kerja video Comfy mendukung text-to-video dan image-to-video melalui graph yang dikonfigurasi.
OpenClaw tidak meneruskan video input ke alur kerja Comfy. Hanya prompt teks dan satu gambar referensi yang didukung sebagai input.
Plugin bawaan mendaftarkan provider pembuatan musik untuk output audio atau musik yang didefinisikan alur kerja, yang ditampilkan melalui tool music_generate bersama:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
Gunakan bagian config music untuk mengarahkan ke JSON alur kerja audio dan node output Anda.
Config gambar tingkat atas yang sudah ada (tanpa bagian image bertingkat) tetap berfungsi:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}
OpenClaw memperlakukan bentuk lama tersebut sebagai config alur kerja gambar. Anda tidak perlu segera bermigrasi, tetapi bagian bertingkat image / video / music disarankan untuk pengaturan baru.
Jika Anda hanya menggunakan pembuatan gambar, config datar lama dan bagian image bertingkat baru secara fungsional setara.
Cakupan live opt-in tersedia untuk plugin bawaan:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
Pengujian live melewati kasus gambar, video, atau musik individual kecuali bagian alur kerja Comfy yang cocok telah dikonfigurasi.

​
Terkait

Pembuatan Gambar

Konfigurasi dan penggunaan tool pembuatan gambar.

Pembuatan Video

Konfigurasi dan penggunaan tool pembuatan video.

Pembuatan Musik

Pengaturan tool pembuatan musik dan audio.

Direktori Provider

Ikhtisar semua provider dan referensi model.

Referensi konfigurasi

Referensi config lengkap termasuk default agen.