الانتقال إلى المحتوى الرئيسي
يدعم OpenClaw نماذج Gemini مع الإسناد إلى Google Search المدمج، الذي يعيد إجابات مركّبة بالذكاء الاصطناعي ومدعومة بنتائج Google Search المباشرة مع استشهادات.

​
الحصول على مفتاح API

1

Create a key

انتقل إلى Google AI Studio وأنشئ مفتاح API.
2

Store the key

اضبط GEMINI_API_KEY في بيئة Gateway، أو أعد استخدام models.providers.google.apiKey، أو اضبط مفتاحًا مخصصًا لبحث الويب عبر:
openclaw configure --section web

​
الإعداد

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set
            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // optional; falls back to models.providers.google.baseUrl
            model: "gemini-2.5-flash", // default
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
أولوية بيانات الاعتماد: يستخدم بحث الويب في Gemini plugins.entries.google.config.webSearch.apiKey أولًا، ثم GEMINI_API_KEY، ثم models.providers.google.apiKey. بالنسبة إلى عناوين URL الأساسية، تكون الأولوية لـ plugins.entries.google.config.webSearch.baseUrl المخصص قبل models.providers.google.baseUrl. لتثبيت Gateway، ضع مفاتيح البيئة في ~/.openclaw/.env.

​
كيف يعمل

بخلاف مزودي البحث التقليديين الذين يعيدون قائمة من الروابط والمقتطفات، يستخدم Gemini الإسناد إلى Google Search لإنتاج إجابات مركّبة بالذكاء الاصطناعي مع استشهادات مضمنة. تتضمن النتائج كلًا من الإجابة المركّبة وعناوين URL للمصادر.
  • تُحل عناوين URL للاستشهادات من إسناد Gemini تلقائيًا من عناوين URL لإعادة التوجيه من Google إلى عناوين URL مباشرة.
  • يستخدم حل إعادة التوجيه مسار حارس SSRF (HEAD + فحوص إعادة التوجيه + التحقق من http/https) قبل إرجاع عنوان URL النهائي للاستشهاد.
  • يستخدم حل إعادة التوجيه إعدادات SSRF الافتراضية الصارمة، لذلك تُحظر عمليات إعادة التوجيه إلى الأهداف الخاصة/الداخلية.

​
المعلمات المدعومة

يدعم بحث Gemini query وfreshness وdate_after وdate_before. يُقبل count للتوافق المشترك مع web_search، لكن إسناد Gemini لا يزال يعيد إجابة مركّبة واحدة مع استشهادات بدلًا من قائمة نتائج بعدد N. يقبل freshness القيم day وweek وmonth وyear، والاختصارات المشتركة pd وpw وpm وpy. تضيف day/pd تعليمة حداثة إلى استعلام Gemini بدلًا من نطاق صارم مدته 24 ساعة. تضبط week وmonth وyear ونطاقات date_after/date_before الصريحة timeRangeFilter الخاص بإسناد Gemini إلى Google Search. لا تُدعم country وlanguage وdomain_filter.

​
اختيار النموذج

النموذج الافتراضي هو gemini-2.5-flash (سريع وفعال من حيث التكلفة). يمكن استخدام أي نموذج Gemini يدعم الإسناد عبر plugins.entries.google.config.webSearch.model.

​
تجاوزات عنوان URL الأساسي

اضبط plugins.entries.google.config.webSearch.baseUrl عندما يجب أن يمر بحث الويب في Gemini عبر وكيل للمشغّل أو نقطة نهاية مخصصة متوافقة مع Gemini. إذا لم يُضبط ذلك، يعيد بحث الويب في Gemini استخدام models.providers.google.baseUrl. تُطبّع قيمة https://generativelanguage.googleapis.com العادية إلى https://generativelanguage.googleapis.com/v1beta؛ وتُحفظ مسارات الوكيل المخصصة كما قُدمت بعد إزالة الشرطات المائلة اللاحقة.

​
ذو صلة