ComfyUI

OpenClaw कार्यप्रवाह-संचालित ComfyUI रन के लिए एक बंडल किया हुआ comfy plugin प्रदान करता है। यह plugin पूरी तरह कार्यप्रवाह-संचालित है: OpenClaw सामान्य size, aspectRatio, resolution, durationSeconds, या TTS-शैली नियंत्रणों को आपके ग्राफ़ पर मैप नहीं करता।

गुण	विवरण
प्रदाता	`comfy`
मॉडल	`comfy/workflow`
साझा टूल	`image_generate`, `video_generate`, `music_generate`
प्रमाणीकरण	स्थानीय ComfyUI के लिए कोई नहीं; Comfy Cloud के लिए `COMFY_API_KEY` या `COMFY_CLOUD_API_KEY`
API	ComfyUI `/prompt` / `/history` / `/view`; Comfy Cloud `/api/*`

यह क्या समर्थित करता है

कार्यप्रवाह JSON से छवि निर्माण और संपादन (संपादन में 1 अपलोड की गई संदर्भ छवि ली जाती है)
कार्यप्रवाह JSON से वीडियो निर्माण, टेक्स्ट-से-वीडियो या छवि-से-वीडियो (1 संदर्भ छवि)
साझा music_generate टूल के माध्यम से संगीत/ऑडियो निर्माण, वैकल्पिक 1 संदर्भ छवि के साथ
कॉन्फ़िगर किए गए Node से आउटपुट डाउनलोड, या कोई Node कॉन्फ़िगर न होने पर सभी मेल खाने वाले आउटपुट Node से

आरंभ करना

ComfyUI को अपनी मशीन पर चलाने या Comfy Cloud का उपयोग करने में से चुनें।

स्थानीय
Comfy Cloud

इसके लिए सर्वोत्तम: अपनी मशीन या LAN पर अपना ComfyUI इंस्टेंस चलाना।

ComfyUI को स्थानीय रूप से शुरू करें

सुनिश्चित करें कि आपका स्थानीय ComfyUI इंस्टेंस चल रहा है (डिफ़ॉल्ट http://127.0.0.1:8188 है)।

अपना कार्यप्रवाह JSON तैयार करें

ComfyUI कार्यप्रवाह JSON फ़ाइल एक्सपोर्ट करें या बनाएँ। प्रॉम्प्ट इनपुट Node और उस आउटपुट Node की Node ID नोट करें जिससे आप OpenClaw द्वारा पढ़वाना चाहते हैं।

प्रदाता कॉन्फ़िगर करें

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 मॉडल पर इंगित करें:

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

सत्यापित करें

openclaw models list --provider comfy

इसके लिए सर्वोत्तम: स्थानीय GPU संसाधनों का प्रबंधन किए बिना Comfy Cloud पर कार्यप्रवाह चलाना।

API कुंजी प्राप्त करें

comfy.org पर साइन अप करें और अपने खाता डैशबोर्ड से API कुंजी जनरेट करें।

API कुंजी सेट करें

इनमें से किसी भी विधि से अपनी कुंजी प्रदान करें:

# ऑनबोर्डिंग फ़्लैग
openclaw onboard --comfy-api-key "your-key"

# पर्यावरण चर (डेमन के लिए वरीय)
export COMFY_API_KEY="your-key"

# वैकल्पिक पर्यावरण चर
export COMFY_CLOUD_API_KEY="your-key"

# या कॉन्फ़िगरेशन में इनलाइन
openclaw config set plugins.entries.comfy.config.apiKey "your-key"

अपना कार्यप्रवाह JSON तैयार करें

ComfyUI कार्यप्रवाह JSON फ़ाइल एक्सपोर्ट करें या बनाएँ। प्रॉम्प्ट इनपुट Node और आउटपुट Node की Node ID नोट करें।

प्रदाता कॉन्फ़िगर करें

mode: "cloud" सेट करें और अपनी कार्यप्रवाह फ़ाइल निर्दिष्ट करें:

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

क्लाउड मोड में baseUrl का डिफ़ॉल्ट https://cloud.comfy.org होता है। केवल कस्टम क्लाउड एंडपॉइंट के लिए baseUrl सेट करें।

डिफ़ॉल्ट मॉडल सेट करें

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

सत्यापित करें

openclaw models list --provider comfy

कॉन्फ़िगरेशन

Comfy साझा शीर्ष-स्तरीय कनेक्शन सेटिंग के साथ-साथ प्रति-क्षमता कार्यप्रवाह अनुभागों (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",
          },
        },
      },
    },
  },
}

साझा कुंजियाँ

कुंजी	प्रकार	विवरण
`mode`	`"local"` या `"cloud"`	कनेक्शन मोड। डिफ़ॉल्ट `"local"` है।
`baseUrl`	स्ट्रिंग	स्थानीय के लिए डिफ़ॉल्ट `http://127.0.0.1:8188` या क्लाउड के लिए `https://cloud.comfy.org` है।
`apiKey`	स्ट्रिंग	वैकल्पिक इनलाइन कुंजी, `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY` पर्यावरण चरों का विकल्प।
`allowPrivateNetwork`	बूलियन	क्लाउड मोड में निजी/LAN `baseUrl` या स्थानीय निजी-DNS FQDN की अनुमति दें।

local मोड में, लूपबैक/निजी IP लिटरल और http://comfyui:8188 जैसे एकल-लेबल सेवा नाम allowPrivateNetwork के बिना काम करते हैं। https://comfy.local.example.com जैसे सार्वजनिक दिखने वाले निजी-DNS FQDN के लिए allowPrivateNetwork: true आवश्यक है। निजी-उद्गम विश्वास कॉन्फ़िगर की गई स्कीम, होस्टनेम और पोर्ट तक सीमित रहता है; स्थानीय रीडायरेक्ट कॉन्फ़िगर किए गए होस्टनेम से बाहर नहीं जा सकते, जबकि सार्वजनिक CDN पर क्लाउड रीडायरेक्ट की जाँच डिफ़ॉल्ट SSRF नीति से होती है।

प्रति-क्षमता कुंजियाँ

ये कुंजियाँ image, video, या music अनुभागों के भीतर लागू होती हैं:

कुंजी	आवश्यक	डिफ़ॉल्ट	विवरण
`workflow` या `workflowPath`	हाँ	—	इनलाइन कार्यप्रवाह JSON, या ComfyUI कार्यप्रवाह JSON फ़ाइल का पथ।
`promptNodeId`	हाँ	—	टेक्स्ट प्रॉम्प्ट प्राप्त करने वाली Node ID।
`promptInputName`	नहीं	`"text"`	प्रॉम्प्ट Node पर इनपुट का नाम।
`outputNodeId`	नहीं	—	आउटपुट पढ़ने के लिए Node ID। छोड़े जाने पर, सभी मेल खाने वाले आउटपुट Node उपयोग किए जाते हैं।
`pollIntervalMs`	नहीं	`1500`	कार्य पूरा होने के लिए मिलीसेकंड में पोलिंग अंतराल।
`timeoutMs`	नहीं	`300000`	कार्यप्रवाह रन के लिए मिलीसेकंड में टाइमआउट।

image और video अनुभाग संदर्भ-छवि इनपुट Node का भी समर्थन करते हैं:

कुंजी	आवश्यक	डिफ़ॉल्ट	विवरण
`inputImageNodeId`	हाँ (संदर्भ छवि पास करते समय)	—	अपलोड की गई संदर्भ छवि प्राप्त करने वाली Node ID।
`inputImageInputName`	नहीं	`"image"`	छवि Node पर इनपुट का नाम।

apiKey या तो एक लिटरल स्ट्रिंग या गोपनीय संदर्भ ऑब्जेक्ट स्वीकार करता है।

कार्यप्रवाह विवरण

छवि कार्यप्रवाह

डिफ़ॉल्ट छवि मॉडल को comfy/workflow पर सेट करें:

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

संदर्भ-छवि संपादन उदाहरण:अपलोड की गई संदर्भ छवि से छवि संपादन सक्षम करने के लिए, अपनी छवि कॉन्फ़िगरेशन में inputImageNodeId जोड़ें:

{
  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 वीडियो कार्यप्रवाह कॉन्फ़िगर किए गए ग्राफ़ के माध्यम से टेक्स्ट-से-वीडियो और छवि-से-वीडियो का समर्थन करते हैं।

OpenClaw इनपुट वीडियो को Comfy कार्यप्रवाहों में पास नहीं करता। इनपुट के रूप में केवल टेक्स्ट प्रॉम्प्ट और एकल संदर्भ छवियाँ समर्थित हैं।

संगीत कार्यप्रवाह

बंडल किया हुआ plugin कार्यप्रवाह-परिभाषित ऑडियो या संगीत आउटपुट के लिए एक संगीत-निर्माण प्रदाता पंजीकृत करता है, जिसे साझा music_generate टूल के माध्यम से प्रस्तुत किया जाता है। यह एक वैकल्पिक संदर्भ छवि स्वीकार करता है (अधिकतम 1):

/tool music_generate prompt="नर्म टेप टेक्सचर वाला गर्म परिवेशी सिंथ लूप"

अपने ऑडियो कार्यप्रवाह JSON और आउटपुट Node को निर्दिष्ट करने के लिए music कॉन्फ़िगरेशन अनुभाग का उपयोग करें।

पश्चगामी संगतता

मौजूदा शीर्ष-स्तरीय छवि कॉन्फ़िगरेशन (नेस्ट किए गए image अनुभाग के बिना) अभी भी काम करता है:

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

OpenClaw उस पुराने प्रारूप को इमेज वर्कफ़्लो कॉन्फ़िगरेशन मानता है। आपको तुरंत माइग्रेट करने की आवश्यकता नहीं है, लेकिन नए सेटअप के लिए नेस्टेड image / video / music अनुभाग अनुशंसित हैं। यदि आप केवल इमेज जनरेशन का उपयोग करते हैं, तो पुराना फ़्लैट कॉन्फ़िगरेशन और नया नेस्टेड image अनुभाग कार्यात्मक रूप से समान हैं।

लाइव परीक्षण

बंडल किए गए Plugin के लिए ऑप्ट-इन लाइव कवरेज उपलब्ध है:

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

यदि संबंधित Comfy वर्कफ़्लो अनुभाग कॉन्फ़िगर नहीं किया गया है, तो लाइव परीक्षण अलग-अलग इमेज, वीडियो या संगीत मामलों को छोड़ देता है।

इमेज जनरेशन

इमेज जनरेशन टूल का कॉन्फ़िगरेशन और उपयोग।

वीडियो जनरेशन

वीडियो जनरेशन टूल का कॉन्फ़िगरेशन और उपयोग।

संगीत जनरेशन

संगीत और ऑडियो जनरेशन टूल का सेटअप।

प्रोवाइडर डायरेक्टरी

सभी प्रोवाइडर और मॉडल रेफ़ का अवलोकन।

कॉन्फ़िगरेशन संदर्भ

एजेंट डिफ़ॉल्ट सहित संपूर्ण कॉन्फ़िगरेशन संदर्भ।

Overview

Concepts and configuration

Providers

यह क्या समर्थित करता है

आरंभ करना

कॉन्फ़िगरेशन

साझा कुंजियाँ

प्रति-क्षमता कुंजियाँ

कार्यप्रवाह विवरण

संबंधित

इमेज जनरेशन

वीडियो जनरेशन

संगीत जनरेशन

प्रोवाइडर डायरेक्टरी

कॉन्फ़िगरेशन संदर्भ

​यह क्या समर्थित करता है

​आरंभ करना

​कॉन्फ़िगरेशन

​साझा कुंजियाँ

​प्रति-क्षमता कुंजियाँ

​कार्यप्रवाह विवरण

​संबंधित

इमेज जनरेशन

वीडियो जनरेशन

संगीत जनरेशन

प्रोवाइडर डायरेक्टरी

कॉन्फ़िगरेशन संदर्भ

यह क्या समर्थित करता है

आरंभ करना

कॉन्फ़िगरेशन

साझा कुंजियाँ

प्रति-क्षमता कुंजियाँ

कार्यप्रवाह विवरण

संबंधित