Providers

ComfyUI

OpenClaw มาพร้อม Plugin comfy ที่รวมมาในระบบสำหรับการรัน ComfyUI แบบขับเคลื่อนด้วยเวิร์กโฟลว์ทั้งหมด Plugin นี้ขับเคลื่อนด้วยเวิร์กโฟลว์ทั้งหมด ดังนั้น OpenClaw จะไม่พยายามแมป size, aspectRatio, resolution, durationSeconds หรือการควบคุมแบบ TTS ทั่วไปไปยังกราฟของคุณ

Property	รายละเอียด
Provider	`comfy`
Models	`comfy/workflow`
Shared surfaces	`image_generate`, `video_generate`, `music_generate`
Auth	ไม่มีสำหรับ ComfyUI ภายในเครื่อง; `COMFY_API_KEY` หรือ `COMFY_CLOUD_API_KEY` สำหรับ Comfy Cloud
API	ComfyUI `/prompt` / `/history` / `/view` และ Comfy Cloud `/api/*`

สิ่งที่รองรับ

การสร้างรูปภาพจากเวิร์กโฟลว์ JSON
การแก้ไขรูปภาพด้วยรูปอ้างอิงที่อัปโหลด 1 รูป
การสร้างวิดีโอจากเวิร์กโฟลว์ JSON
การสร้างวิดีโอด้วยรูปอ้างอิงที่อัปโหลด 1 รูป
การสร้างเพลงหรือเสียงผ่านเครื่องมือ music_generate ที่ใช้ร่วมกัน
การดาวน์โหลดเอาต์พุตจาก node ที่กำหนดค่าไว้ หรือจากทุก output node ที่ตรงกัน

เริ่มต้นใช้งาน

เลือกระหว่างการรัน ComfyUI บนเครื่องของคุณเองหรือใช้ Comfy Cloud

Local

เหมาะสำหรับ: การรันอินสแตนซ์ ComfyUI ของคุณเองบนเครื่องหรือ LAN ของคุณ

เริ่ม ComfyUI ภายในเครื่อง

ตรวจสอบให้แน่ใจว่าอินสแตนซ์ ComfyUI ภายในเครื่องของคุณกำลังทำงานอยู่ (ค่าเริ่มต้นคือ http://127.0.0.1:8188)

เตรียมเวิร์กโฟลว์ JSON ของคุณ

export หรือสร้างไฟล์เวิร์กโฟลว์ JSON ของ ComfyUI จด node ID สำหรับ prompt input node และ output node ที่คุณต้องการให้ OpenClaw อ่าน

กำหนดค่า provider

ตั้งค่า mode: "local" และชี้ไปยังไฟล์เวิร์กโฟลว์ของคุณ ด้านล่างคือตัวอย่างรูปภาพขั้นต่ำ:

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

ตั้งค่าโมเดลเริ่มต้น

ชี้ OpenClaw ไปที่โมเดล comfy/workflow สำหรับ capability ที่คุณกำหนดค่าไว้:

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

ตรวจสอบ

openclaw models list --provider comfy

Comfy Cloud

เหมาะสำหรับ: การรันเวิร์กโฟลว์บน Comfy Cloud โดยไม่ต้องจัดการทรัพยากร GPU ภายในเครื่อง

รับ API key

สมัครใช้งานที่ comfy.org และสร้าง API key จากแดชบอร์ดบัญชีของคุณ

ตั้งค่า API key

ระบุคีย์ของคุณด้วยวิธีใดวิธีหนึ่งต่อไปนี้:

# ตัวแปร environment (แนะนำ)
export COMFY_API_KEY="your-key"

# ตัวแปร environment ทางเลือก
export COMFY_CLOUD_API_KEY="your-key"

# หรือกำหนดใน config โดยตรง
openclaw config set plugins.entries.comfy.config.apiKey "your-key"

เตรียมเวิร์กโฟลว์ JSON ของคุณ

export หรือสร้างไฟล์เวิร์กโฟลว์ JSON ของ ComfyUI จด node ID สำหรับ prompt input node และ output node

กำหนดค่า provider

ตั้งค่า mode: "cloud" และชี้ไปยังไฟล์เวิร์กโฟลว์ของคุณ:

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

ตั้งค่าโมเดลเริ่มต้น

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

ตรวจสอบ

openclaw models list --provider comfy

การกำหนดค่า

Comfy รองรับการตั้งค่าการเชื่อมต่อระดับบนสุดที่ใช้ร่วมกัน รวมถึงส่วนเวิร์กโฟลว์แยกตาม 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",
          },
        },
      },
    },
  },
}

คีย์ที่ใช้ร่วมกัน

Key	Type	คำอธิบาย
`mode`	`"local"` or `"cloud"`	โหมดการเชื่อมต่อ
`baseUrl`	string	ค่าเริ่มต้นคือ `http://127.0.0.1:8188` สำหรับ local หรือ `https://cloud.comfy.org` สำหรับ cloud
`apiKey`	string	คีย์แบบ inline ที่เป็นทางเลือกแทนตัวแปร env `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY`
`allowPrivateNetwork`	boolean	อนุญาต `baseUrl` แบบ private/LAN ในโหมด cloud

คีย์แยกตาม capability

คีย์เหล่านี้ใช้ภายในส่วน image, video หรือ music:

Key	Required	Default	คำอธิบาย
`workflow` or `workflowPath`	Yes	--	พาธไปยังไฟล์เวิร์กโฟลว์ JSON ของ ComfyUI
`promptNodeId`	Yes	--	Node ID ที่รับ text prompt
`promptInputName`	No	`"text"`	ชื่อ input บน prompt node
`outputNodeId`	No	--	Node ID ที่จะอ่านเอาต์พุต หากไม่ระบุ จะใช้ทุก output node ที่ตรงกัน
`pollIntervalMs`	No	--	ช่วงเวลา polling เป็นมิลลิวินาทีสำหรับรอให้งานเสร็จสิ้น
`timeoutMs`	No	--	ค่า timeout เป็นมิลลิวินาทีสำหรับการรันเวิร์กโฟลว์

ส่วน image และ video ยังรองรับ:

Key	Required	Default	คำอธิบาย
`inputImageNodeId`	Yes (when passing a reference image)	--	Node ID ที่รับรูปอ้างอิงที่อัปโหลด
`inputImageInputName`	No	`"image"`	ชื่อ input บน image node

รายละเอียดเวิร์กโฟลว์

เวิร์กโฟลว์รูปภาพ

ตั้งค่าโมเดลรูปภาพเริ่มต้นเป็น comfy/workflow:

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

ตัวอย่างการแก้ไขด้วยรูปอ้างอิง:

หากต้องการเปิดใช้การแก้ไขรูปภาพด้วยรูปอ้างอิงที่อัปโหลด ให้เพิ่ม inputImageNodeId ลงใน config รูปภาพของคุณ:

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

เวิร์กโฟลว์วิดีโอ

ตั้งค่าโมเดลวิดีโอเริ่มต้นเป็น comfy/workflow:

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

เวิร์กโฟลว์วิดีโอของ Comfy รองรับ text-to-video และ image-to-video ผ่านกราฟที่กำหนดค่าไว้

เวิร์กโฟลว์เพลง

Plugin ที่รวมมากับระบบจะลงทะเบียน provider สำหรับการสร้างเพลงที่กำหนดโดยเวิร์กโฟลว์สำหรับเอาต์พุตเสียงหรือเพลง ซึ่งแสดงผ่านเครื่องมือ music_generate ที่ใช้ร่วมกัน:

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

ใช้ส่วน config music เพื่อชี้ไปยังเวิร์กโฟลว์ JSON สำหรับเสียงและ output node ของคุณ

ความเข้ากันได้ย้อนหลัง

config รูปภาพระดับบนสุดแบบเดิม (โดยไม่มีส่วน image แบบซ้อน) ยังใช้งานได้:

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

OpenClaw จะถือว่าโครงสร้างแบบเดิมนี้เป็น config เวิร์กโฟลว์รูปภาพ คุณยังไม่จำเป็นต้องย้ายทันที แต่สำหรับการตั้งค่าใหม่ แนะนำให้ใช้ส่วน image / video / music แบบซ้อน

Live tests

มีการทดสอบ live แบบ opt-in สำหรับ Plugin ที่รวมมากับระบบ:

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

live test จะข้ามกรณีรูปภาพ วิดีโอ หรือเพลงแต่ละกรณี หากไม่มีการกำหนดค่าส่วนเวิร์กโฟลว์ Comfy ที่ตรงกัน

ที่เกี่ยวข้อง

การสร้างรูปภาพ

การกำหนดค่าและการใช้งานเครื่องมือสร้างรูปภาพ

การสร้างวิดีโอ

การกำหนดค่าและการใช้งานเครื่องมือสร้างวิดีโอ

การสร้างเพลง

การตั้งค่าเครื่องมือสร้างเพลงและเสียง

ไดเรกทอรี Provider

ภาพรวมของ Provider ทั้งหมดและ model refs

ข้อมูลอ้างอิง config

ข้อมูลอ้างอิง config แบบเต็ม รวมถึงค่าเริ่มต้นของ agent

# สิ่งที่รองรับ

# เริ่มต้นใช้งาน

Local

เริ่ม ComfyUI ภายในเครื่อง

เตรียมเวิร์กโฟลว์ JSON ของคุณ

กำหนดค่า provider

ตั้งค่าโมเดลเริ่มต้น

ตรวจสอบ

Comfy Cloud

รับ API key

ตั้งค่า API key

เตรียมเวิร์กโฟลว์ JSON ของคุณ

กำหนดค่า provider

ตั้งค่าโมเดลเริ่มต้น

ตรวจสอบ

# การกำหนดค่า

# คีย์ที่ใช้ร่วมกัน

# คีย์แยกตาม capability

# รายละเอียดเวิร์กโฟลว์

# ที่เกี่ยวข้อง

สิ่งที่รองรับ

เริ่มต้นใช้งาน

การกำหนดค่า

คีย์ที่ใช้ร่วมกัน

คีย์แยกตาม capability

รายละเอียดเวิร์กโฟลว์

ที่เกี่ยวข้อง