دليل OpenClaw الكامل لدمج واجهة برمجة تطبيقات Nano Banana Pro: 3 خطوات للتكوين + 5 مهارات موصى بها

OpenClaw يتكامل مع Nano Banana Pro: أقوى وكيل ذكاء اصطناعي مفتوح المصدر يلتقي بأقوى نموذج لتوليد الصور

OpenClaw هو منصة وكلاء الذكاء الاصطناعي مفتوحة المصدر الأكثر شعبية حاليًا على GitHub (مع أكثر من 250 ألف نجمة)، و Nano Banana Pro هو نموذج توليد الصور الرائد من Google DeepMind. يتيح لك دمج هذين الاثنين استدعاء قدرات توليد صور احترافية بالاستوديو في أي وقت عبر أكثر من 12 منصة مثل WhatsApp و Telegram و Slack وغيرها. والأفضل من ذلك، من خلال APIYI، تبلغ تكلفة NB Pro بدقة 1K إلى 4K نفس السعر وهو 0.05 دولار لكل استدعاء، أي ما يعادل 20% من سعر الموقع الرسمي.

القيمة الأساسية: بنهاية هذا المقال، ستكون قد أكملت إعداد وتكوين OpenClaw + NB Pro، وأتقنت طريقة استدعاء الكود، وتعرفت على 5 مهارات (Skills) في OpenClaw يمكنها تحسين كفاءة توليد الصور بشكل كبير.

مقدمة عن منصة OpenClaw: لماذا تختارها كمنصة للوصول إلى Nano Banana Pro

قبل البدء في الإعداد، دعنا نلقي نظرة سريعة على القدرات الأساسية لـ OpenClaw، ولماذا تعد المنصة المثالية للوصول إلى NB Pro.

نظرة سريعة على المعلومات الأساسية لـ OpenClaw

ما يميز OpenClaw هو آلية "نبضات القلب" (Heartbeat) – حيث يمكن للذكاء الاصطناعي تنشيط نفسه بشكل استباقي عبر مهام Cron و Webhooks، دون الحاجة إلى إرسال رسالة منك لتشغيله. هذا يعني أنه يمكنك إعداد سير عمل مؤتمت مثل "إنشاء مواد تسويقية تلقائية لليوم في الساعة 9 صباحًا كل يوم"، بالاقتران مع قدرات توليد الصور في NB Pro، لتحقيق إبداع ذكاء اصطناعي يعمل بدون إشراف فعلي.

🚀 تجربة سريعة: إذا لم تكن قد قمت بتثبيت OpenClaw بعد، يمكنك تجربة تأثيرات توليد الصور لـ NB Pro عبر الإنترنت أولاً على imagen.apiyi.com قبل اتخاذ قرار بشأن الاتصال. توفر APIYI حدود اختبار مجانية، مما يتيح لك توليد الصور دون الحاجة إلى إعدادات معقدة.

تثبيت OpenClaw

# macOS / Linux
curl -fsSL https://get.openclaw.ai | bash

# أو باستخدام npm
npm install -g @openclaw/openclaw

بعد التثبيت، قم بتشغيل الأمر openclaw لبدء معالج الإعداد.

ربط OpenClaw بواجهة برمجة تطبيقات Nano Banana Pro: إعداد في 3 خطوات

الفكرة الأساسية للربط بسيطة: قم بتسجيل APIYI كمزود نموذج مخصص في OpenClaw، ثم قم بتكوين نموذج Nano Banana Pro. تتوافق APIYI تمامًا مع تنسيق واجهة برمجة تطبيقات Google الرسمية، لذا كل ما عليك فعله هو استبدال عنوان الطلب ومفتاح API.

الخطوة 1: الحصول على مفتاح APIYI

1. قم بزيارة الموقع الرسمي لـ APIYI apiyi.com للتسجيل.
2. انتقل إلى لوحة التحكم، وأنشئ مفتاح API جديد.
3. تأكد من تفعيل Nano Banana Pro ( gemini-3-pro-image-preview ) في قائمة النماذج.

الخطوة 2: تحرير ملف تكوين OpenClaw

افتح ملف تكوين OpenClaw ~/.openclaw/openclaw.json وأضف APIYI كمزود مخصص:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "your-apiyi-key",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-image-preview",
            "name": "Nano Banana Pro"
          },
          {
            "id": "gemini-3.1-flash-image-preview",
            "name": "Nano Banana 2"
          }
        ]
      }
    }
  }
}

الخطوة 3: تعيين نموذج توليد الصور الافتراضي

في نفس ملف التكوين، حدد NB Pro كنموذج افتراضي لتوليد الصور:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3-pro-image-preview"
      }
    }
  }
}

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3-pro-image-preview"
      }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-your-apiyi-key-here",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-image-preview",
            "name": "Nano Banana Pro",
            "contextWindow": 65536,
            "cost": {
              "input": 0.25,
              "output": 60.0
            }
          },
          {
            "id": "gemini-3.1-flash-image-preview",
            "name": "Nano Banana 2",
            "contextWindow": 131072,
            "cost": {
              "input": 0.125,
              "output": 30.0
            }
          }
        ]
      }
    }
  }
}

بعد الانتهاء من التكوين، أعد تشغيل OpenClaw لتطبيق التغييرات.

نقاط أساسية لتكوين OpenClaw مع NB Pro

💡 ملاحظة هامة: يجب تعيين حقل api إلى google-generative-ai وليس openai-completions. يستخدم NB Pro تنسيق نقطة النهاية الأصلية لـ Google generateContent، وتتوافق APIYI تمامًا مع هذا التنسيق. إذا استخدمت وضع التوافق مع OpenAI، فلن تعمل وظيفة توليد الصور بشكل صحيح.

استدعاء واجهة برمجة تطبيقات Nano Banana Pro: استخدام مباشر بالتنسيق الرسمي

تتوافق APIYI تمامًا مع تنسيق الاستدعاء في وثائق Google الرسمية. إذا كنت تستخدم واجهات برمجة التطبيقات الرسمية من Google بالفعل، فما عليك سوى إجراء تعديلين:

1. استبدال عنوان الطلب: قم بتغيير generativelanguage.googleapis.com إلى api.apiyi.com.
2. استبدال مفتاح API: استخدم المفتاح المقدم من APIYI.

مثال على استدعاء واجهة برمجة تطبيقات Nano Banana Pro (Python)

import google.generativeai as genai

# تهيئة نقطة نهاية APIYI - فقط استبدل العنوان والمفتاح
genai.configure(
    api_key="your-apiyi-key",
    client_options={"api_endpoint": "api.apiyi.com"}
)

model = genai.GenerativeModel("gemini-3-pro-image-preview")

response = model.generate_content(
    "قط برتقالي يجلس على عتبة نافذة ويشاهد المطر، بأسلوب أنمي ياباني، إضاءة داخلية دافئة",
    generation_config=genai.GenerationConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config={"image_size": "2K", "aspect_ratio": "16:9"}
    )
)

# استخراج الصورة المولدة
for part in response.candidates[0].content.parts:
    if hasattr(part, "inline_data"):
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)
        print("تم حفظ الصورة: output.png")
    elif hasattr(part, "text"):
        print(f"الوصف: {part.text}")

curl -X POST "https://api.apiyi.com/v1/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: your-apiyi-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "أنشئ مشهدًا ليليًا لمدينة بأسلوب السايبربانك، مع انعكاس أضواء النيون على الشوارع المبللة"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "imageSize": "4K",
        "aspectRatio": "21:9"
      }
    }
  }'

const { GoogleGenerativeAI } = require("@google/generative-ai");
const fs = require("fs");

// تهيئة نقطة نهاية APIYI
const genAI = new GoogleGenerativeAI("your-apiyi-key", {
  baseUrl: "https://api.apiyi.com/v1"
});

const model = genAI.getGenerativeModel({
  model: "gemini-3-pro-image-preview"
});

async function generateImage() {
  const result = await model.generateContent({
    contents: [{
      role: "user",
      parts: [{ text: "لوحة بأسلوب الرسم بالحبر الصيني لمناظر طبيعية جبلية مائية، جبال بعيدة ومياه قريبة، مع ترك مساحات بيضاء للتعبير عن الجو" }]
    }],
    generationConfig: {
      responseModalities: ["TEXT", "IMAGE"],
      imageConfig: { imageSize: "4K", aspectRatio: "3:2" }
    }
  });

  const response = result.response;
  for (const part of response.candidates[0].content.parts) {
    if (part.inlineData) {
      const imageBuffer = Buffer.from(part.inlineData.data, "base64");
      fs.writeFileSync("output.png", imageBuffer);
      console.log("تم حفظ الصورة: output.png");
    }
  }
}

generateImage();

شرح معلمات الدقة الكاملة لـ Nano Banana Pro

🎯 ميزة التكلفة: NB Pro بسعر موحد $0.05/استدعاء لجميع الدقات من 1K إلى 4K على APIYI. هذا يعني أن تكلفة إنشاء صورة فائقة الدقة بدقة 4K (4096×4096) هي نفسها تمامًا تكلفة صورة 1K، لذا يمكنك اختيار 4K مباشرة للحصول على أفضل جودة للصورة.

اختبار والتحقق من توليد الصور في OpenClaw Nano Banana Pro

بعد الانتهاء من الإعداد، يمكنك إرسال رسالة مباشرة في OpenClaw لاختبار تأثير توليد الصور.

الاختبار في OpenClaw

أرسل مباشرةً في أي منصة رسائل متصلة (Telegram، WhatsApp، إلخ):

ساعدني في إنشاء صورة: كلب شيبا يرتدي نظارة شمسية ويركب الأمواج على الشاطئ، والشمس مشرقة، بأسلوب كرتوني

سيقوم OpenClaw تلقائيًا باستدعاء نموذج NB Pro الذي قمت بإعداده، وإنشاء الصورة، والرد بها في المحادثة.

اختبار توليد الصور عبر الإنترنت

إذا كنت ترغب في اختبار جودة توليد الصور لنموذج NB Pro قبل إعداد OpenClaw، يمكنك استخدام أداة الاختبار عبر الإنترنت التي توفرها APIYI:

• رابط اختبار توليد الصور: imagen.apiyi.com
• لا حاجة لكتابة أي كود، فقط أدخل الموجه (prompt) عبر الإنترنت لتوليد الصور.
• يدعم جميع معلمات الدقة ونسب العرض إلى الارتفاع.
• مناسب للتحقق السريع من فعالية الموجهات.

تنزيل أمثلة الكود

توفر APIYI حزمة كاملة من أكواد التطوير المرجعية، تتضمن أمثلة استدعاء بلغات متعددة مثل Python و Node.js و cURL:

• تنزيل أمثلة الكود: xinqikeji.feishu.cn/wiki/W4vEwdiCPi3VfTkrL5hcVlDxnQf
• وثائق Google الرسمية: ai.google.dev/gemini-api/docs/image-generation

💰 نصيحة للتحكم في التكاليف: في مرحلة التطوير والاختبار، يُنصح باستخدام NB2 (0.035 دولار/استدعاء) لتوفير التكاليف. بعد الإطلاق الرسمي، قم بالتبديل إلى NB Pro (0.05 دولار/استدعاء) للحصول على أفضل جودة للصورة. في منصة APIYI، تحتاج فقط إلى تعديل معرف النموذج، ولا يلزم تغيير أي كود آخر.

مهارات OpenClaw الموصى بها: 5 مهارات لتعزيز كفاءة توليد الصور لـ Nano Banana Pro

تكمن قوة OpenClaw في نظامه البيئي للمهارات. يوجد 5,490+ مهارة مجتمعية على ClawHub، إليك 5 منها الأكثر صلة بتوليد الصور:

المهارة 1: مولد الصور (Image Generator)

القيمة الأساسية لهذه المهارة هي تحسين الموجهات. ما عليك سوى قول "ارسم لي قطة"، وستقوم بتوسيعها تلقائيًا إلى موجهات احترافية تتضمن تفاصيل الأسلوب والإضاءة والتكوين، مما يعزز بشكل كبير جودة الصور المولدة بواسطة NB Pro.

المهارة 2: منشئ الصور الدفعي (Batch Image Creator)

مناسب للمشاهد التي تحتاج إلى توليد صور متعددة دفعة واحدة، مثل صور منتجات التجارة الإلكترونية، أو تقويم محتوى الوسائط الاجتماعية لأسبوع. يمكن لهذه المهارة:

• توليد صور متعددة بزوايا/أنماط مختلفة بناءً على موضوع واحد
• إدارة قائمة الانتظار للتوليد تلقائيًا، وتجنب تفعيل حدود المعدل
• دعم الموجهات القابلة للقوالب، واستبدال المتغيرات الرئيسية لتوليد الصور دفعة واحدة

المهارة 3: محرر الصور (Image Editor)

لا يقتصر دور NB Pro على توليد الصور فحسب، بل يدعم أيضًا التعديل بناءً على صور مرجعية. تغلف هذه المهارة سير عمل تعديل الصور:

• تحميل الصورة الأصلية + وصف نصي لمتطلبات التعديل
• دعم التعديل الجزئي (تغيير الخلفية، تعديل الألوان، إضافة عناصر)
• معالجة تحويل تنسيق الصور وترميز Base64 تلقائيًا

المهارة 4: ناشر الوسائط الاجتماعية (Social Media Poster)

مهارة توليد صور مصممة خصيصًا للوسائط الاجتماعية:

• قوالب مدمجة بأبعاد مثالية لمنصات مثل Instagram و Twitter و Xiaohongshu
• توليد تلقائي للملصقات مع نصوص (باستخدام قدرة NB Pro الممتازة على عرض النصوص)
• دعم إعدادات ألوان العلامة التجارية واتساق الأسلوب

المهارة 5: مجدول الصور التلقائي (Heartbeat Image Scheduler)

استخدام آلية Heartbeat الفريدة لـ OpenClaw لتحقيق التوليد التلقائي للصور في أوقات محددة:

• تعيين تعبير Cron لتشغيل توليد الصور في أوقات محددة
• على سبيل المثال، "توليد صورة تحية صباحية كل يوم الساعة 8:00 صباحًا"
• يتم إرسال الصور المولدة تلقائيًا إلى منصة الرسائل المحددة
• مناسب لفرق التشغيل لإنتاج المحتوى بشكل آلي

طريقة تثبيت المهارات

تثبيت المهارات في OpenClaw بسيط للغاية:

# التثبيت عبر ClawHub
openclaw skill install image-generator

# أو اطلب من الذكاء الاصطناعي التثبيت مباشرة في الرسالة
# أرسل: "تثبيت مهارة image-generator"

يمكنك أيضًا تصفح دليل المهارات الكامل على موقع ClawHub: clawhub.openclaw.ai

🎯 أفضل الممارسات: يوصى بتثبيت مهارة Image Generator أولاً، فهي تساعدك على تحسين الموجهات تلقائيًا، مما يعزز بشكل كبير جودة الصور المولدة بواسطة NB Pro. بالاقتران مع ميزة التكلفة المنخفضة لـ APIYI apiyi.com، يمكنك التكرار بثقة عدة مرات، والعثور بسرعة على التأثير الأكثر إرضاءً.

Nano Banana Pro مقابل NB2: كيفية الاختيار في OpenClaw

تدعم APIYI كلا النموذجين، NB Pro و NB2، وقد تمت إضافتهما بالفعل في تكوين OpenClaw. اختر النموذج المناسب بناءً على السيناريوهات المختلفة:

في OpenClaw، يمكنك التبديل بين النماذج ببساطة عن طريق تعديل تعليمات الرسالة:

# توليد صور باستخدام NB Pro (الافتراضي)
استخدم NB Pro لمساعدتي في توليد صورة دعائية لمنتج

# التبديل إلى NB2 للتوليد السريع
استخدم NB2 لتوليد 5 خيارات شعار بأنماط مختلفة بسرعة

أو قم بتبديل النموذج الافتراضي مؤقتًا في ملف التكوين:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3.1-flash-image-preview"
      }
    }
  }
}

أسئلة شائعة

الخلاصة: النقاط الأساسية لتوصيل OpenClaw بـ Nano Banana Pro

الخطوات الأساسية لتوصيل OpenClaw بـ Nano Banana Pro:

1. الحصول على المفتاح: سجل في APIYI apiyi.com واحصل على مفتاح API.
2. تحرير التكوين: أضف مزود APIYI في ~/.openclaw/openclaw.json، واضبط api على google-generative-ai.
3. اختيار النموذج: NB Pro (0.05 دولار أمريكي لكل استدعاء، أعلى جودة) أو NB2 (0.035 دولار أمريكي لكل استدعاء، الأولوية للسرعة).
4. تثبيت المهارات (Skills): قم بتثبيت مهارات مثل مولد الصور (Image Generator) من ClawHub لزيادة الكفاءة.
5. بدء التوليد: أرسل وصفًا باللغة الطبيعية في أي منصة رسائل لتوليد الصور.

Nano Banana Pro هو النموذج الرئيسي الأكثر استهلاكًا على منصة APIYI يوميًا، وقد استثمرت المنصة موارد تشغيل وصيانة كبيرة للحفاظ على استقراره – مما يضمن إعادة توجيه رسمية، وعدم وجود حد للسرعة، وإمكانية الاستخدام التجاري. يتم تسعير جميع الدقات من 1K إلى 4K بسعر موحد قدره 0.05 دولار أمريكي لكل استدعاء، بينما تبلغ الخدمة المماثلة على الموقع الرسمي 0.234 دولار أمريكي لكل استدعاء، أي حوالي 20٪ فقط من السعر الأصلي.

يوصى بالوصول إلى Nano Banana Pro عبر APIYI apiyi.com، بالاقتران مع نظام المهارات البيئي لـ OpenClaw، لبناء سير عمل فعال لتوليد صور الذكاء الاصطناعي.

الدعم الفني: APIYI apiyi.com – منصة موثوقة ومستقرة لإعادة توجيه واجهات برمجة تطبيقات نماذج الذكاء الاصطناعي الكبيرة، تبدأ من 20٪ من السعر الأصلي لسلسلة NB Pro الكاملة