الانتقال إلى المحتوى الرئيسي

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 مع الرسم البياني لديك.
الخاصيةالتفاصيل
الموفّرcomfy
النماذجcomfy/workflow
الواجهات المشتركةimage_generate, video_generate, music_generate
المصادقةلا شيء لـ ComfyUI المحلي؛ أو COMFY_API_KEY أو COMFY_CLOUD_API_KEY لـ Comfy Cloud
APIComfyUI /prompt / /history / /view وComfy Cloud /api/*

​
ما الذي يدعمه

  • إنشاء الصور من ملف JSON لسير العمل
  • تحرير الصور باستخدام صورة مرجعية واحدة مرفوعة
  • إنشاء الفيديو من ملف JSON لسير العمل
  • إنشاء الفيديو باستخدام صورة مرجعية واحدة مرفوعة
  • إنشاء الموسيقى أو الصوت عبر الأداة المشتركة music_generate
  • تنزيل المخرجات من Node مُعدّ أو من كل Nodes المخرجات المطابقة

​
البدء

اختر بين تشغيل ComfyUI على جهازك أو استخدام Comfy Cloud.
الأفضل لـ: تشغيل مثيل ComfyUI الخاص بك على جهازك أو على شبكة LAN.
1

تشغيل ComfyUI محليًا

تأكد من أن مثيل ComfyUI المحلي قيد التشغيل (القيمة الافتراضية هي http://127.0.0.1:8188).
2

تحضير JSON الخاص بسير العمل

صدّر أو أنشئ ملف JSON لسير عمل ComfyUI. دوّن معرّفات Node الخاصة بعقدة إدخال الموجّه وعقدة الإخراج التي تريد أن يقرأ OpenClaw منها.
3

إعداد الموفّر

اضبط 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 للإمكانات التي قمت بإعدادها:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

التحقق

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" or "cloud"وضع الاتصال.
baseUrlstringالقيمة الافتراضية هي http://127.0.0.1:8188 للوضع المحلي أو https://cloud.comfy.org لوضع cloud.
apiKeystringمفتاح مضمن اختياري، بديل عن متغيرات البيئة COMFY_API_KEY / COMFY_CLOUD_API_KEY.
allowPrivateNetworkbooleanالسماح باستخدام baseUrl خاص/على شبكة LAN في وضع cloud.

​
المفاتيح الخاصة بكل قدرة

تنطبق هذه المفاتيح داخل أقسام image أو video أو music:
المفتاحمطلوبالافتراضيالوصف
workflow or workflowPathنعم—مسار ملف JSON لسير عمل ComfyUI.
promptNodeIdنعم—معرّف Node الذي يستقبل موجّه النص.
promptInputNameلا"text"اسم الإدخال على Node الموجّه.
outputNodeIdلا—معرّف Node الذي تُقرأ منه المخرجات. إذا تم حذفه، تُستخدم كل Nodes المخرجات المطابقة.
pollIntervalMsلا—فاصل الاستطلاع بالميلي ثانية لاكتمال المهمة.
timeoutMsلا—المهلة بالميلي ثانية لتشغيل سير العمل.
يدعم قسما image وvideo أيضًا ما يلي:
المفتاحمطلوبالافتراضيالوصف
inputImageNodeIdنعم (عند تمرير صورة مرجعية)—معرّف Node الذي يستقبل الصورة المرجعية المرفوعة.
inputImageInputNameلا"image"اسم الإدخال على Node الصورة.

​
تفاصيل سير العمل

اضبط نموذج الصور الافتراضي على 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:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
استخدم قسم إعدادات music للتوجيه إلى JSON الخاص بسير عمل الصوت وعقدة الإخراج.
ما زالت إعدادات الصور القديمة على المستوى الأعلى (من دون قسم image المتداخل) تعمل:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}
يتعامل OpenClaw مع هذا الشكل القديم باعتباره إعدادات سير عمل الصور. لا تحتاج إلى الترحيل فورًا، لكن يُنصح باستخدام الأقسام المتداخلة image / video / music في الإعدادات الجديدة.
إذا كنت تستخدم إنشاء الصور فقط، فإن الإعدادات المسطحة القديمة وقسم image المتداخل الجديد متكافئان وظيفيًا.
توجد تغطية live اختيارية لـ Plugin المضمّن:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
يتخطى اختبار live الحالات الفردية للصور أو الفيديو أو الموسيقى ما لم يكن قسم سير عمل Comfy المطابق مُعدًا.

​
ذو صلة

إنشاء الصور

إعدادات أداة إنشاء الصور وطريقة استخدامها.

إنشاء الفيديو

إعدادات أداة إنشاء الفيديو وطريقة استخدامها.

إنشاء الموسيقى

إعداد أداة إنشاء الموسيقى والصوت.

دليل الموفّرين

نظرة عامة على جميع الموفّرين ومراجع النماذج.

مرجع الإعدادات

مرجع الإعدادات الكامل بما في ذلك الإعدادات الافتراضية للوكيل.