image_generate للوكيل إنشاء الصور وتحريرها باستخدام
الموفّرين الذين ضبطتهم. في جلسات الدردشة، يعمل إنشاء الصور بشكل غير متزامن:
يسجل OpenClaw مهمة في الخلفية، ويعيد معرّف المهمة فورًا، ويوقظ
الوكيل عندما ينتهي الموفّر. يتبع وكيل الإكمال وضع الرد المرئي العادي
للجلسة: تسليم الرد النهائي تلقائيًا عند ضبطه، أو message(action="send")
عندما تتطلب الجلسة أداة الرسائل. إذا كانت جلسة الطالب غير نشطة أو فشل
إيقاظها النشط، وكانت بعض الصور المنشأة لا تزال مفقودة من رد الإكمال، يرسل
OpenClaw رجوعًا مباشرًا متطابقًا لا يتكرر يحتوي على الصور المفقودة فقط.
لا تظهر الأداة إلا عند توفر موفّر واحد على الأقل لإنشاء الصور.
إذا لم ترَ
image_generate ضمن أدوات وكيلك، فاضبط
agents.defaults.imageGenerationModel، أو أعدّ مفتاح API لموفّر،
أو سجّل الدخول باستخدام OpenAI ChatGPT/Codex OAuth.البدء السريع
ضبط المصادقة
عيّن مفتاح API لموفّر واحد على الأقل (مثل
OPENAI_API_KEY،
GEMINI_API_KEY، OPENROUTER_API_KEY) أو سجّل الدخول باستخدام OpenAI Codex OAuth.اختيار نموذج افتراضي (اختياري)
openai/gpt-image-2. عند
ضبط ملف تعريف OAuth باسم openai، يوجّه OpenClaw طلبات الصور
عبر ملف تعريف OAuth ذلك بدلًا من تجربة
OPENAI_API_KEY أولًا. يؤدي ضبط models.providers.openai الصريح (مفتاح API،
عنوان URL أساسي مخصص/Azure) إلى العودة إلى مسار OpenAI Images API
المباشر.المسارات الشائعة
| الهدف | مرجع النموذج | المصادقة |
|---|---|---|
| إنشاء صور OpenAI مع فوترة API | openai/gpt-image-2 | OPENAI_API_KEY |
| إنشاء صور OpenAI باستخدام مصادقة اشتراك Codex | openai/gpt-image-2 | OpenAI ChatGPT/Codex OAuth |
| PNG/WebP بخلفية شفافة من OpenAI | openai/gpt-image-1.5 | OPENAI_API_KEY أو OpenAI Codex OAuth |
| إنشاء صور DeepInfra | deepinfra/black-forest-labs/FLUX-1-schnell | DEEPINFRA_API_KEY |
| إنشاء fal Krea 2 تعبيري/موجّه بالأسلوب | fal/krea/v2/medium/text-to-image | FAL_KEY |
| إنشاء صور OpenRouter | openrouter/google/gemini-3.1-flash-image-preview | OPENROUTER_API_KEY |
| إنشاء صور LiteLLM | litellm/gpt-image-2 | LITELLM_API_KEY |
| إنشاء صور Microsoft Foundry MAI | microsoft-foundry/<deployment-name> | AZURE_OPENAI_API_KEY أو Entra ID |
| إنشاء صور Google Gemini | google/gemini-3.1-flash-image-preview | GEMINI_API_KEY أو GOOGLE_API_KEY |
image_generate نفسها مع التحويل من نص إلى صورة وتحرير الصور
المرجعية. استخدم image لمرجع واحد أو images لعدة مراجع.
بالنسبة إلى نماذج Krea 2 على fal، تُرسل تلك المراجع كمراجع أسلوب
بدلًا من مدخلات تحرير.
تُمرر تلميحات الإخراج المدعومة من الموفّر مثل quality وoutputFormat و
background عند توفرها، ويُبلّغ عنها كمتجاهلة عندما لا يدعمها
الموفّر. دعم الخلفية الشفافة المضمّن
خاص بـ OpenAI؛ وقد يحافظ موفّرون آخرون على شفافية PNG إذا كان
نظامهم الخلفي يصدرها.
الموفّرون المدعومون
| الموفّر | النموذج الافتراضي | دعم التحرير | المصادقة |
|---|---|---|---|
| ComfyUI | workflow | نعم (صورة واحدة، مضبوطة في سير العمل) | COMFY_API_KEY أو COMFY_CLOUD_API_KEY للسحابة |
| DeepInfra | black-forest-labs/FLUX-1-schnell | نعم (صورة واحدة) | DEEPINFRA_API_KEY |
| fal | fal-ai/flux/dev | نعم (حدود خاصة بالنموذج) | FAL_KEY |
gemini-3.1-flash-image-preview | نعم | GEMINI_API_KEY أو GOOGLE_API_KEY | |
| LiteLLM | gpt-image-2 | نعم (حتى 5 صور إدخال) | LITELLM_API_KEY |
| Microsoft Foundry | <deployment-name> | نعم (نماذج MAI-Image-2.5 فقط) | AZURE_OPENAI_API_KEY أو Entra ID (az login) |
| MiniMax | image-01 | نعم (مرجع موضوع) | MINIMAX_API_KEY أو MiniMax OAuth (minimax-portal) |
| OpenAI | gpt-image-2 | نعم (حتى 4 صور) | OPENAI_API_KEY أو OpenAI ChatGPT/Codex OAuth |
| OpenRouter | google/gemini-3.1-flash-image-preview | نعم (حتى 5 صور إدخال) | OPENROUTER_API_KEY |
| Vydra | grok-imagine | لا | VYDRA_API_KEY |
| xAI | grok-imagine-image | نعم (حتى 5 صور) | XAI_API_KEY |
action: "list" لفحص الموفّرين والنماذج المتاحة وقت التشغيل:
action: "status" لفحص مهمة إنشاء الصور النشطة للجلسة
الحالية:
قدرات الموفّرين
| القدرة | ComfyUI | DeepInfra | fal | Microsoft Foundry | MiniMax | OpenAI | Vydra | xAI | |
|---|---|---|---|---|---|---|---|---|---|
| الإنشاء (العدد الأقصى) | محدد في سير العمل | 4 | 4 | 4 | 1 | 9 | 4 | 1 | 4 |
| التحرير / المرجع | صورة واحدة (سير العمل) | صورة واحدة | Flux: 1؛ GPT: 10؛ مراجع أسلوب Krea: 10؛ NB2: 14 | حتى 5 صور | صورة واحدة | صورة واحدة (مرجع موضوع) | حتى 5 صور | - | حتى 5 صور |
| التحكم في الحجم | - | ✓ | ✓ | ✓ | ✓ | - | حتى 4K | - | - |
| نسبة العرض إلى الارتفاع | - | - | ✓ | ✓ | - | ✓ | - | - | ✓ |
| الدقة (1K/2K/4K) | - | - | ✓ | ✓ | - | - | - | - | 1K, 2K |
معلمات الأداة
موجه إنشاء الصور. مطلوب لـ
action: "generate".استخدم
"status" لفحص مهمة الجلسة النشطة أو "list" لفحص
الموفّرين والنماذج المتاحة وقت التشغيل.تجاوز الموفّر/النموذج (مثل
openai/gpt-image-2). استخدم
openai/gpt-image-1.5 لخلفيات OpenAI الشفافة.مسار صورة مرجعية واحد أو URL واحد لوضع التحرير.
عدة صور مرجعية لوضع التحرير أو نماذج مراجع الأسلوب (حتى 10
عبر الأداة المشتركة؛ تظل الحدود الخاصة بالموفّر سارية).
تلميح الحجم:
1024x1024، 1536x1024، 1024x1536، 2048x2048، 3840x2160.نسبة العرض إلى الارتفاع:
1:1، 2:3، 3:2، 2.35:1، 3:4، 4:3، 4:5،
5:4، 9:16، 16:9، 21:9، 4:1، 1:4، 8:1، 1:8. يتحقق الموفّرون
من المجموعة الفرعية الخاصة بنموذجهم.تلميح الدقة.
تلميح الجودة عندما يدعمه الموفّر.
تلميح تنسيق الإخراج عندما يدعمه الموفّر.
تلميح الخلفية عندما يدعمه الموفّر. استخدم
transparent مع
outputFormat: "png" أو "webp" للموفّرين القادرين على الشفافية.عدد الصور المراد إنشاؤها (1-4).
مهلة اختيارية لطلب الموفّر بالمللي ثانية. عندما يستدعي Codex
image_generate عبر الأدوات الديناميكية، تظل هذه القيمة الخاصة بكل استدعاء تتجاوز
الافتراضي المضبوط وتُحد عند 600000 مللي ثانية.تلميح اسم ملف الإخراج.
تلميحات خاصة بـ OpenAI فقط:
background وmoderation وoutputCompression وuser.التحكم في إبداع fal Krea 2. الافتراضي هو
medium.لا يدعم جميع الموفّرين كل المعلمات. عندما يدعم موفّر رجوع
خيار هندسة قريبًا بدلًا من الخيار المطلوب بالضبط، يعيد OpenClaw الربط إلى
أقرب حجم أو نسبة عرض إلى ارتفاع أو دقة مدعومة قبل الإرسال.
تُسقط تلميحات الإخراج غير المدعومة للموفّرين الذين لا يصرحون
بالدعم، ويُبلّغ عنها في نتيجة الأداة. تبلّغ نتائج الأداة عن الإعدادات
المطبقة؛ ويلتقط
details.normalization أي ترجمة من المطلوب إلى المطبق.الضبط
اختيار النموذج
ترتيب اختيار الموفّر
يجرب OpenClaw الموفّرين بهذا الترتيب:- معامل
modelمن استدعاء الأداة (إذا حدده الوكيل). imageGenerationModel.primaryمن الإعدادات.imageGenerationModel.fallbacksبالترتيب.- الاكتشاف التلقائي - افتراضيات المزوّد المدعومة بالمصادقة فقط:
- المزوّد الافتراضي الحالي أولاً؛
- بقية مزوّدي توليد الصور المسجلين بترتيب معرف المزوّد.
تجاوزات النموذج لكل استدعاء دقيقة
تجاوزات النموذج لكل استدعاء دقيقة
يحاول تجاوز
model لكل استدعاء ذلك المزوّد/النموذج فقط ولا
يتابع إلى primary/fallback المكوّنة أو المزوّدين المكتشفين تلقائياً.الاكتشاف التلقائي يراعي المصادقة
الاكتشاف التلقائي يراعي المصادقة
لا يدخل افتراضي المزوّد في قائمة المرشحين إلا عندما يستطيع OpenClaw
مصادقة ذلك المزوّد فعلياً. اضبط
agents.defaults.mediaGenerationAutoProviderFallback: false لاستخدام
إدخالات model وprimary وfallbacks الصريحة فقط.المهل الزمنية
المهل الزمنية
اضبط
agents.defaults.imageGenerationModel.timeoutMs للواجهات الخلفية
البطيئة للصور. يتجاوز معامل الأداة timeoutMs لكل استدعاء القيمة
الافتراضية المكوّنة، وتتجاوز الافتراضيات المكوّنة افتراضيات المزوّد
التي يحددها Plugin. تستخدم مزوّدات الصور المستضافة من Google وOpenRouter
افتراضيات قدرها 180 ثانية؛ ويستخدم توليد الصور في Microsoft Foundry MAI
وxAI وAzure OpenAI مدة 600 ثانية. تستخدم استدعاءات أدوات Codex الديناميكية
افتراضياً جسراً image_generate مدته 120 ثانية وتحترم ميزانية المهلة نفسها
عند تكوينها، ضمن الحد الأقصى لجسر الأدوات الديناميكية في OpenClaw وهو
600000 مللي ثانية.الفحص وقت التشغيل
الفحص وقت التشغيل
استخدم
action: "list" لفحص المزوّدين المسجلين حالياً،
ونماذجهم الافتراضية، وتلميحات متغيرات بيئة المصادقة.تحرير الصور
يدعم OpenAI وOpenRouter وGoogle وDeepInfra وfal وMicrosoft Foundry وMiniMax وComfyUI وxAI تحرير الصور المرجعية. تستخدم نماذج Krea 2 على fal حقولimage / images نفسها كمراجع أسلوب بدلاً من مدخلات التحرير. مرّر
مسار صورة مرجعية أو URL:
images. يدعم fal صورة مرجعية واحدة لتحويل Flux من صورة إلى صورة، وما يصل
إلى 10 لتحريرات GPT Image 2، وما يصل إلى 10 مراجع أسلوب لـ Krea 2، وما يصل
إلى 14 لتحريرات Nano Banana 2. يدعم Microsoft Foundry وMiniMax وComfyUI صورة
واحدة.
تعمقات المزوّدين
OpenAI gpt-image-2 (و gpt-image-1.5)
OpenAI gpt-image-2 (و gpt-image-1.5)
يتم توليد الصور في OpenAI افتراضياً عبر يقبل
openai/gpt-image-2. إذا كان
ملف تعريف OAuth لـ openai مكوّناً، يعيد OpenClaw استخدام ملف تعريف
OAuth نفسه المستخدم من نماذج دردشة اشتراك Codex ويرسل طلب الصورة عبر
الواجهة الخلفية Codex Responses. تتم صياغة URLs الأساسية القديمة لـ Codex
مثل https://chatgpt.com/backend-api إلى الصيغة القياسية
https://chatgpt.com/backend-api/codex لطلبات الصور. لا يرجع OpenClaw
ضمنياً إلى OPENAI_API_KEY لذلك الطلب - لفرض التوجيه المباشر إلى
OpenAI Images API، كوّن models.providers.openai صراحة باستخدام مفتاح API
أو URL أساسي مخصص أو نقطة نهاية Azure.لا يزال يمكن اختيار نماذج openai/gpt-image-1.5 وopenai/gpt-image-1
وopenai/gpt-image-1-mini صراحة. استخدم gpt-image-1.5 لإخراج PNG/WebP
بخلفية شفافة؛ ترفض API الحالية لـ gpt-image-2 القيمة
background: "transparent".يدعم gpt-image-2 توليد الصور من النص وتحرير الصور المرجعية من خلال
أداة image_generate نفسها. يمرر OpenClaw prompt وcount وsize
وquality وoutputFormat والصور المرجعية إلى OpenAI. لا يتلقى OpenAI
aspectRatio أو resolution مباشرة؛ وعندما يكون ذلك ممكناً، يخرطهما
OpenClaw إلى size مدعوم، وإلا تبلغ الأداة عنهما كتجاوزات متجاهلة.تعيش الخيارات الخاصة بـ OpenAI تحت كائن openai:openai.background القيم transparent أو opaque أو auto؛
تتطلب المخرجات الشفافة outputFormat بقيمة png أو webp ونموذج صور
OpenAI قادراً على الشفافية. يوجه OpenClaw طلبات الخلفية الشفافة الافتراضية
لـ gpt-image-2 إلى gpt-image-1.5. ينطبق openai.outputCompression على
مخرجات JPEG/WebP ويتم تجاهله لمخرجات PNG.تلميح background في المستوى الأعلى محايد تجاه المزوّد ويُخرط حالياً إلى
حقل طلب background نفسه في OpenAI عند اختيار مزوّد OpenAI. تعيد المزوّدات
التي لا تصرح بدعم الخلفية هذا التلميح في ignoredOverrides بدلاً من تلقي
المعامل غير المدعوم.لتوجيه توليد صور OpenAI عبر نشر Azure OpenAI بدلاً من api.openai.com، راجع
نقاط نهاية Azure OpenAI.نماذج صور Microsoft Foundry MAI
نماذج صور Microsoft Foundry MAI
يستخدم توليد الصور في Microsoft Foundry أسماء نشر صور MAI المنشورة تحت
بادئة المزوّد يستخدم المزوّد MAI API من Microsoft Foundry، وليس OpenAI Images API:
microsoft-foundry/. لا يوجد نموذج افتراضي على مستوى المزوّد
لأن MAI API تتوقع اسم النشر الخاص بك في حقل model:- نقطة نهاية التوليد:
/mai/v1/images/generations - نقطة نهاية التحرير:
/mai/v1/images/edits - المصادقة:
AZURE_OPENAI_API_KEY/ مفتاح API للمزوّد، أو Entra ID عبرaz login - المخرج: صورة PNG واحدة
- الحجم: الافتراضي
1024x1024؛ يجب أن يكون العرض والارتفاع كلاً منهما 768 px على الأقل، ويجب ألا يتجاوز إجمالي البكسلات 1,048,576 - التحريرات: صورة مرجعية PNG أو JPEG واحدة، مدعومة فقط بواسطة نشرات
MAI-Image-2.5-FlashوMAI-Image-2.5
MAI-Image-2.5-Flash أو MAI-Image-2.5.نماذج صور MAI الحالية هي MAI-Image-2.5-Flash وMAI-Image-2.5
وMAI-Image-2e وMAI-Image-2. راجع
Microsoft Foundry Plugin للإعداد
وسلوك نماذج الدردشة.نماذج صور OpenRouter
نماذج صور OpenRouter
يستخدم توليد الصور في OpenRouter مفتاح يمرر OpenClaw
OPENROUTER_API_KEY نفسه
ويوجه عبر API صور إكمالات الدردشة في OpenRouter. اختر نماذج صور
OpenRouter باستخدام بادئة openrouter/:prompt وcount والصور المرجعية وتلميحات
aspectRatio / resolution المتوافقة مع Gemini إلى OpenRouter.
تشمل اختصارات نماذج صور OpenRouter المضمنة الحالية
google/gemini-3.1-flash-image-preview،
وgoogle/gemini-3-pro-image-preview، وopenai/gpt-5.4-image-2. استخدم
action: "list" لمعرفة ما يكشفه Plugin المكوّن لديك.fal Krea 2
fal Krea 2
تستخدم نماذج Krea 2 على fal مخطط Krea الأصلي في fal بدلاً من مخطط
يعيد Krea 2 حالياً صورة واحدة لكل طلب. فضّل
image_size العام المستخدم بواسطة Flux. يرسل OpenClaw:aspect_ratioلتلميحات نسبة العرض إلى الارتفاعcreativity، بقيمة افتراضيةmediumimage_style_referencesعند توفيرimageأوimages
aspectRatio مع Krea؛
يخرط OpenClaw size إلى أقرب نسبة عرض إلى ارتفاع مدعومة في Krea ويرفض
resolution مع Krea بدلاً من إسقاطه. استخدم fal.creativity عندما تريد
مستوى إبداع Krea أصلياً:مصادقة MiniMax المزدوجة
مصادقة MiniMax المزدوجة
يتوفر توليد الصور في MiniMax عبر مساري مصادقة MiniMax المضمنين:
minimax/image-01لإعدادات مفتاح APIminimax-portal/image-01لإعدادات OAuth
xAI grok-imagine-image
xAI grok-imagine-image
يستخدم مزوّد xAI المضمن
/v1/images/generations للطلبات المعتمدة على
الموجّه فقط و/v1/images/edits عند وجود image أو images.- النماذج:
xai/grok-imagine-image،xai/grok-imagine-image-quality - العدد: حتى 4
- المراجع:
imageواحدة أو ما يصل إلى خمسimages - نسب العرض إلى الارتفاع:
1:1،16:9،9:16،4:3،3:4،2:3،3:2 - الدقات:
1K،2K - المخرجات: تُعاد كمرفقات صور يديرها OpenClaw
quality أو mask أو user الأصلية في xAI
أو نسب العرض إلى الارتفاع الإضافية الأصلية فقط إلى أن توجد هذه عناصر التحكم
في عقد image_generate المشترك عبر المزوّدين.أمثلة
- توليد (منظر طبيعي 4K)
- توليد (PNG شفافة)
- توليد (جودة منخفضة من OpenAI)
- Generate (two square)
- Edit (one reference)
- Edit (multiple references)
- Krea style references
--output-format و--background و--quality و
--openai-moderation نفسها في openclaw infer image edit؛
ويبقى --openai-background اسمًا مستعارًا خاصًا بـ OpenAI. لا يعلن المزوّدون
المضمّنون غير OpenAI عن تحكم صريح في الخلفية حاليًا، لذلك يتم الإبلاغ عن
background: "transparent" بأنه متجاهل لديهم.
ذات صلة
- نظرة عامة على الأدوات - جميع أدوات الوكيل المتاحة
- ComfyUI - إعداد سير عمل ComfyUI المحلي وComfy Cloud
- fal - إعداد مزوّد الصور والفيديو fal
- Google (Gemini) - إعداد مزوّد الصور Gemini
- Plugin Microsoft Foundry - إعداد دردشة Microsoft Foundry وصور MAI
- MiniMax - إعداد مزوّد الصور MiniMax
- OpenAI - إعداد مزوّد OpenAI Images
- Vydra - إعداد الصور والفيديو والكلام في Vydra
- xAI - إعداد الصور والفيديو والبحث وتنفيذ التعليمات البرمجية وTTS في Grok
- مرجع التهيئة - إعداد
imageGenerationModel - النماذج - تهيئة النماذج وتجاوز الفشل