Skip to main content

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 มาพร้อม Plugin comfy ที่รวมมาในระบบสำหรับการรัน ComfyUI แบบขับเคลื่อนด้วยเวิร์กโฟลว์ทั้งหมด Plugin นี้ขับเคลื่อนด้วยเวิร์กโฟลว์ทั้งหมด ดังนั้น OpenClaw จะไม่พยายามแมป size, aspectRatio, resolution, durationSeconds หรือการควบคุมแบบ TTS ทั่วไปไปยังกราฟของคุณ
Propertyรายละเอียด
Providercomfy
Modelscomfy/workflow
Shared surfacesimage_generate, video_generate, music_generate
Authไม่มีสำหรับ ComfyUI ภายในเครื่อง; COMFY_API_KEY หรือ COMFY_CLOUD_API_KEY สำหรับ Comfy Cloud
APIComfyUI /prompt / /history / /view และ Comfy Cloud /api/*

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

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

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

เลือกระหว่างการรัน ComfyUI บนเครื่องของคุณเองหรือใช้ Comfy Cloud
เหมาะสำหรับ: การรันอินสแตนซ์ ComfyUI ของคุณเองบนเครื่องหรือ LAN ของคุณ
1

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

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

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

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

กำหนดค่า 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",
          },
        },
      },
    },
  },
}
4

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

ชี้ OpenClaw ไปที่โมเดล comfy/workflow สำหรับ capability ที่คุณกำหนดค่าไว้:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

ตรวจสอบ

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",
          },
        },
      },
    },
  },
}

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

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

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

คีย์เหล่านี้ใช้ภายในส่วน image, video หรือ music:
KeyRequiredDefaultคำอธิบาย
workflow or workflowPathYes—พาธไปยังไฟล์เวิร์กโฟลว์ JSON ของ ComfyUI
promptNodeIdYes—Node ID ที่รับ text prompt
promptInputNameNo"text"ชื่อ input บน prompt node
outputNodeIdNo—Node ID ที่จะอ่านเอาต์พุต หากไม่ระบุ จะใช้ทุก output node ที่ตรงกัน
pollIntervalMsNo—ช่วงเวลา polling เป็นมิลลิวินาทีสำหรับรอให้งานเสร็จสิ้น
timeoutMsNo—ค่า timeout เป็นมิลลิวินาทีสำหรับการรันเวิร์กโฟลว์
ส่วน image และ video ยังรองรับ:
KeyRequiredDefaultคำอธิบาย
inputImageNodeIdYes (when passing a reference image)—Node ID ที่รับรูปอ้างอิงที่อัปโหลด
inputImageInputNameNo"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 ผ่านกราฟที่กำหนดค่าไว้
OpenClaw จะไม่ส่งวิดีโออินพุตเข้าไปในเวิร์กโฟลว์ Comfy อินพุตที่รองรับมีเพียง text prompts และรูปอ้างอิงเดี่ยวเท่านั้น
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 แบบซ้อน
หากคุณใช้เฉพาะการสร้างรูปภาพ config แบบแบนเดิมและส่วน image แบบซ้อนใหม่จะเทียบเท่ากันในเชิงการทำงาน
มีการทดสอบ 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