> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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` टूल के माध्यम से संगीत या ऑडियो जनरेशन
* कॉन्फ़िगर किए गए नोड या सभी मेल खाते आउटपुट नोड से आउटपुट डाउनलोड

## शुरू करना

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

<Tabs>
  <Tab title="Local">
    **इसके लिए सबसे अच्छा:** अपनी मशीन या LAN पर अपना ComfyUI इंस्टेंस चलाना।

    <Steps>
      <Step title="Start ComfyUI locally">
        पक्का करें कि आपका स्थानीय ComfyUI इंस्टेंस चल रहा है (डिफ़ॉल्ट `http://127.0.0.1:8188`)।
      </Step>

      <Step title="Prepare your workflow JSON">
        ComfyUI कार्यप्रवाह JSON फ़ाइल निर्यात करें या बनाएँ। prompt इनपुट नोड और उस आउटपुट नोड की नोड ID नोट करें जिससे आप OpenClaw को पढ़ाना चाहते हैं।
      </Step>

      <Step title="Configure the provider">
        `mode: "local"` सेट करें और अपनी कार्यप्रवाह फ़ाइल की ओर संकेत करें। यहाँ एक न्यूनतम इमेज उदाहरण है:

        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          plugins: {
            entries: {
              comfy: {
                config: {
                  mode: "local",
                  baseUrl: "http://127.0.0.1:8188",
                  image: {
                    workflowPath: "./workflows/flux-api.json",
                    promptNodeId: "6",
                    outputNodeId: "9",
                  },
                },
              },
            },
          },
        }
        ```
      </Step>

      <Step title="Set the default model">
        आपके द्वारा कॉन्फ़िगर की गई क्षमता के लिए OpenClaw को `comfy/workflow` मॉडल पर निर्देशित करें:

        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              imageGenerationModel: {
                primary: "comfy/workflow",
              },
            },
          },
        }
        ```
      </Step>

      <Step title="Verify">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider comfy
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Comfy Cloud">
    **इसके लिए सबसे अच्छा:** स्थानीय GPU संसाधनों को प्रबंधित किए बिना Comfy Cloud पर कार्यप्रवाह चलाना।

    <Steps>
      <Step title="Get an API key">
        [comfy.org](https://comfy.org) पर साइन अप करें और अपने खाता डैशबोर्ड से API कुंजी जनरेट करें।
      </Step>

      <Step title="Set the API key">
        इनमें से किसी एक विधि से अपनी कुंजी दें:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        # Environment variable (preferred)
        export COMFY_API_KEY="your-key"

        # Alternative environment variable
        export COMFY_CLOUD_API_KEY="your-key"

        # Or inline in config
        openclaw config set plugins.entries.comfy.config.apiKey "your-key"
        ```
      </Step>

      <Step title="Prepare your workflow JSON">
        ComfyUI कार्यप्रवाह JSON फ़ाइल निर्यात करें या बनाएँ। prompt इनपुट नोड और आउटपुट नोड की नोड ID नोट करें।
      </Step>

      <Step title="Configure the provider">
        `mode: "cloud"` सेट करें और अपनी कार्यप्रवाह फ़ाइल की ओर संकेत करें:

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

        <Tip>
          Cloud मोड `baseUrl` को डिफ़ॉल्ट रूप से `https://cloud.comfy.org` पर सेट करता है। आपको `baseUrl` केवल तभी सेट करना होगा जब आप कस्टम cloud endpoint उपयोग करते हैं।
        </Tip>
      </Step>

      <Step title="Set the default model">
        ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
        {
          agents: {
            defaults: {
              imageGenerationModel: {
                primary: "comfy/workflow",
              },
            },
          },
        }
        ```
      </Step>

      <Step title="Verify">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider comfy
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

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

Comfy साझा शीर्ष-स्तरीय कनेक्शन सेटिंग्स के साथ प्रति-क्षमता कार्यप्रवाह सेक्शन (`image`, `video`, `music`) का समर्थन करता है:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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"` | कनेक्शन मोड।                                                                               |
| `baseUrl`             | string                 | स्थानीय के लिए डिफ़ॉल्ट `http://127.0.0.1:8188` या cloud के लिए `https://cloud.comfy.org`। |
| `apiKey`              | string                 | वैकल्पिक inline कुंजी, `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY` env vars का विकल्प।         |
| `allowPrivateNetwork` | boolean                | cloud मोड में private/LAN `baseUrl` की अनुमति दें।                                         |

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

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

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

`image` और `video` सेक्शन इसका भी समर्थन करते हैं:

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

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

<AccordionGroup>
  <Accordion title="Image workflows">
    डिफ़ॉल्ट इमेज मॉडल को `comfy/workflow` पर सेट करें:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "comfy/workflow",
          },
        },
      },
    }
    ```

    **संदर्भ-इमेज संपादन उदाहरण:**

    अपलोड की गई संदर्भ इमेज के साथ इमेज संपादन सक्षम करने के लिए, अपने इमेज config में `inputImageNodeId` जोड़ें:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      plugins: {
        entries: {
          comfy: {
            config: {
              image: {
                workflowPath: "./workflows/edit-api.json",
                promptNodeId: "6",
                inputImageNodeId: "7",
                inputImageInputName: "image",
                outputNodeId: "9",
              },
            },
          },
        },
      },
    }
    ```
  </Accordion>

  <Accordion title="Video workflows">
    डिफ़ॉल्ट वीडियो मॉडल को `comfy/workflow` पर सेट करें:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "comfy/workflow",
          },
        },
      },
    }
    ```

    Comfy वीडियो कार्यप्रवाह कॉन्फ़िगर किए गए ग्राफ के माध्यम से text-to-video और image-to-video का समर्थन करते हैं।

    <Note>
      OpenClaw इनपुट वीडियो को Comfy कार्यप्रवाह में पास नहीं करता। इनपुट के रूप में केवल टेक्स्ट prompt और एकल संदर्भ इमेज समर्थित हैं।
    </Note>
  </Accordion>

  <Accordion title="Music workflows">
    बंडल किया गया Plugin कार्यप्रवाह-परिभाषित ऑडियो या संगीत आउटपुट के लिए music-generation प्रदाता पंजीकृत करता है, जो साझा `music_generate` टूल के माध्यम से प्रस्तुत होता है:

    ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /tool music_generate prompt="Warm ambient synth loop with soft tape texture"
    ```

    अपने ऑडियो कार्यप्रवाह JSON और आउटपुट नोड की ओर संकेत करने के लिए `music` config सेक्शन का उपयोग करें।
  </Accordion>

  <Accordion title="Backward compatibility">
    मौजूदा शीर्ष-स्तरीय इमेज config (nested `image` सेक्शन के बिना) अब भी काम करता है:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      plugins: {
        entries: {
          comfy: {
            config: {
              workflowPath: "./workflows/flux-api.json",
              promptNodeId: "6",
              outputNodeId: "9",
            },
          },
        },
      },
    }
    ```

    OpenClaw उस legacy shape को इमेज कार्यप्रवाह config के रूप में मानता है। आपको तुरंत migrate करने की आवश्यकता नहीं है, लेकिन नए setups के लिए nested `image` / `video` / `music` सेक्शन अनुशंसित हैं।

    <Tip>
      यदि आप केवल इमेज जनरेशन उपयोग करते हैं, तो legacy flat config और नया nested `image` सेक्शन कार्यात्मक रूप से समान हैं।
    </Tip>
  </Accordion>

  <Accordion title="Live tests">
    बंडल किए गए Plugin के लिए opt-in live coverage उपलब्ध है:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
    ```

    जब तक मेल खाता Comfy कार्यप्रवाह सेक्शन कॉन्फ़िगर नहीं होता, live test अलग-अलग इमेज, वीडियो, या संगीत मामलों को छोड़ देता है।
  </Accordion>
</AccordionGroup>

## संबंधित

<CardGroup cols={2}>
  <Card title="छवि जनरेशन" href="/hi/tools/image-generation" icon="image">
    छवि जनरेशन टूल का कॉन्फ़िगरेशन और उपयोग।
  </Card>

  <Card title="वीडियो जनरेशन" href="/hi/tools/video-generation" icon="video">
    वीडियो जनरेशन टूल का कॉन्फ़िगरेशन और उपयोग।
  </Card>

  <Card title="संगीत जनरेशन" href="/hi/tools/music-generation" icon="music">
    संगीत और ऑडियो जनरेशन टूल का सेटअप।
  </Card>

  <Card title="प्रदाता निर्देशिका" href="/hi/providers/index" icon="layers">
    सभी प्रदाताओं और मॉडल refs का अवलोकन।
  </Card>

  <Card title="कॉन्फ़िगरेशन संदर्भ" href="/hi/gateway/config-agents#agent-defaults" icon="gear">
    एजेंट डिफ़ॉल्ट सहित पूरा कॉन्फ़िग संदर्भ।
  </Card>
</CardGroup>