Providers
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 का उपयोग करने में से चुनें।
स्थानीय
इसके लिए सर्वोत्तम: अपनी मशीन या 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 comfyComfy Cloud
इसके लिए सर्वोत्तम: स्थानीय 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", }, }, }, }, },}डिफ़ॉल्ट मॉडल सेट करें
{ 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 की अनुमति दें। |
प्रति-क्षमता कुंजियाँ
ये कुंजियाँ 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 वीडियो कार्यप्रवाह कॉन्फ़िगर किए गए ग्राफ़ के माध्यम से टेक्स्ट-से-वीडियो और छवि-से-वीडियो का समर्थन करते हैं।
संगीत कार्यप्रवाह
बंडल किया हुआ 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 वर्कफ़्लो अनुभाग कॉन्फ़िगर नहीं किया गया है, तो लाइव परीक्षण अलग-अलग इमेज, वीडियो या संगीत मामलों को छोड़ देता है।
