OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

ComfyUI

OpenClaw menyertakan Plugin comfy bawaan untuk menjalankan ComfyUI berbasis alur kerja. Plugin ini sepenuhnya digerakkan oleh alur kerja: OpenClaw tidak memetakan kontrol umum seperti size, aspectRatio, resolution, durationSeconds, atau kontrol bergaya TTS ke grafik Anda.

Properti Detail
Penyedia comfy
Model comfy/workflow
Alat bersama image_generate, video_generate, music_generate
Autentikasi Tidak ada untuk ComfyUI lokal; COMFY_API_KEY atau COMFY_CLOUD_API_KEY untuk Comfy Cloud
API ComfyUI /prompt / /history / /view; Comfy Cloud /api/*

Yang didukung

  • Pembuatan dan penyuntingan gambar dari JSON alur kerja (penyuntingan menerima 1 gambar referensi yang diunggah)
  • Pembuatan video dari JSON alur kerja, teks-ke-video atau gambar-ke-video (1 gambar referensi)
  • Pembuatan musik/audio melalui alat bersama music_generate, dengan 1 gambar referensi opsional
  • Pengunduhan keluaran dari Node yang dikonfigurasi, atau dari semua Node keluaran yang cocok jika tidak ada yang dikonfigurasi

Memulai

Pilih antara menjalankan ComfyUI di mesin Anda sendiri atau menggunakan Comfy Cloud.

Lokal

Paling sesuai untuk: menjalankan instans ComfyUI Anda sendiri di mesin atau LAN Anda.

  • Jalankan ComfyUI secara lokal

    Pastikan instans ComfyUI lokal Anda sedang berjalan (nilai bawaan http://127.0.0.1:8188).

  • Siapkan JSON alur kerja Anda

    Ekspor atau buat berkas JSON alur kerja ComfyUI. Catat ID Node untuk Node masukan perintah dan Node keluaran yang ingin dibaca OpenClaw.

  • Konfigurasikan penyedia

    Tetapkan mode: "local" dan arahkan ke berkas alur kerja Anda. Contoh gambar minimal:

    json5
    {  plugins: {    entries: {      comfy: {        config: {          mode: "local",          baseUrl: "http://127.0.0.1:8188",          image: {            workflowPath: "./workflows/flux-api.json",            promptNodeId: "6",            outputNodeId: "9",          },        },      },    },  },}

  • Tetapkan model bawaan

    Arahkan OpenClaw ke model comfy/workflow untuk kemampuan yang Anda konfigurasikan:

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

  • Verifikasi

    bash
    openclaw models list --provider comfy

    • Comfy Cloud

    Paling sesuai untuk: menjalankan alur kerja di Comfy Cloud tanpa mengelola sumber daya GPU lokal.

  • Dapatkan kunci API

    Daftar di comfy.org dan buat kunci API dari dasbor akun Anda.

  • Tetapkan kunci API

    Berikan kunci Anda melalui salah satu metode berikut:

    bash
    # Flag orientasi awalopenclaw onboard --comfy-api-key "your-key" # Variabel lingkungan (disarankan untuk daemon)export COMFY_API_KEY="your-key" # Variabel lingkungan alternatifexport COMFY_CLOUD_API_KEY="your-key" # Atau langsung di konfigurasiopenclaw config set plugins.entries.comfy.config.apiKey "your-key"

  • Siapkan JSON alur kerja Anda

    Ekspor atau buat berkas JSON alur kerja ComfyUI. Catat ID Node untuk Node masukan perintah dan Node keluaran.

  • Konfigurasikan penyedia

    Tetapkan mode: "cloud" dan arahkan ke berkas alur kerja Anda:

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

  • Tetapkan model bawaan

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

  • Verifikasi

    bash
    openclaw models list --provider comfy

    • Konfigurasi

    Comfy mendukung pengaturan koneksi tingkat atas bersama serta bagian alur kerja per kemampuan (image, video, music):

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

    Kunci Jenis Deskripsi
    mode "local" atau "cloud" Mode koneksi. Nilai bawaan adalah "local".
    baseUrl string Nilai bawaan http://127.0.0.1:8188 untuk lokal atau https://cloud.comfy.org untuk cloud.
    apiKey string Kunci langsung opsional, sebagai alternatif variabel lingkungan COMFY_API_KEY / COMFY_CLOUD_API_KEY.
    allowPrivateNetwork boolean Izinkan baseUrl privat/LAN dalam mode cloud atau FQDN DNS privat lokal.

    Kunci per kemampuan

    Kunci berikut berlaku di dalam bagian image, video, atau music:

    Kunci Wajib Bawaan Deskripsi
    workflow atau workflowPath Ya -- JSON alur kerja langsung, atau jalur ke berkas JSON alur kerja ComfyUI.
    promptNodeId Ya -- ID Node yang menerima perintah teks.
    promptInputName Tidak "text" Nama masukan pada Node perintah.
    outputNodeId Tidak -- ID Node tempat keluaran dibaca. Jika dihilangkan, semua Node keluaran yang cocok akan digunakan.
    pollIntervalMs Tidak 1500 Interval polling dalam milidetik untuk penyelesaian tugas.
    timeoutMs Tidak 300000 Batas waktu dalam milidetik untuk menjalankan alur kerja.

    Bagian image dan video juga mendukung Node masukan gambar referensi:

    Kunci Wajib Bawaan Deskripsi
    inputImageNodeId Ya (saat meneruskan gambar referensi) -- ID Node yang menerima gambar referensi yang diunggah.
    inputImageInputName Tidak "image" Nama masukan pada Node gambar.

    apiKey menerima string literal atau objek referensi rahasia.

    Detail alur kerja

    Alur kerja gambar

    Tetapkan model gambar bawaan ke comfy/workflow:

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

    Contoh penyuntingan gambar referensi:

    Untuk mengaktifkan penyuntingan gambar dengan gambar referensi yang diunggah, tambahkan inputImageNodeId ke konfigurasi gambar Anda:

    json5
    {  plugins: {    entries: {      comfy: {        config: {          image: {            workflowPath: "./workflows/edit-api.json",            promptNodeId: "6",            inputImageNodeId: "7",            inputImageInputName: "image",            outputNodeId: "9",          },        },      },    },  },}
    Alur kerja video

    Tetapkan model video bawaan ke comfy/workflow:

    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "comfy/workflow",      },    },  },}

    Alur kerja video Comfy mendukung teks-ke-video dan gambar-ke-video melalui grafik yang dikonfigurasi.

    Alur kerja musik

    Plugin bawaan mendaftarkan penyedia pembuatan musik untuk keluaran audio atau musik yang ditentukan oleh alur kerja, dan menyediakannya melalui alat bersama music_generate. Alat ini menerima satu gambar referensi opsional (maksimal 1):

    text
    /tool music_generate prompt="Warm ambient synth loop with soft tape texture"

    Gunakan bagian konfigurasi music untuk mengarahkan ke JSON alur kerja audio dan Node keluaran Anda.

    Kompatibilitas mundur

    Konfigurasi gambar tingkat atas yang sudah ada (tanpa bagian image bertingkat) tetap berfungsi:

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

    OpenClaw memperlakukan bentuk lama tersebut sebagai konfigurasi alur kerja gambar. Anda tidak perlu segera melakukan migrasi, tetapi bagian image / video / music bertingkat disarankan untuk penyiapan baru. Jika Anda hanya menggunakan pembuatan gambar, konfigurasi datar lama dan bagian image bertingkat yang baru setara secara fungsional.

    Pengujian langsung

    Cakupan pengujian langsung opsional tersedia untuk Plugin bawaan:

    bash
    OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts

    Pengujian langsung melewati kasus gambar, video, atau musik secara terpisah kecuali bagian alur kerja Comfy yang sesuai telah dikonfigurasi.

    Terkait

    Pembuatan Gambar

    Konfigurasi dan penggunaan alat pembuatan gambar.
    Pembuatan Video

    Konfigurasi dan penggunaan alat pembuatan video.
    Pembuatan Musik

    Penyiapan alat pembuatan musik dan audio.
    Direktori Penyedia

    Ikhtisar semua penyedia dan referensi model.
    Referensi konfigurasi

    Referensi konfigurasi lengkap termasuk nilai default agen.
    Was this useful?
    On this page

    On this page