بحث Gemini

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

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

openclaw configure --section web

الإعداد

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // اختياري إذا كان GEMINI_API_KEY أو models.providers.google.apiKey معيّنًا            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // اختياري؛ يعود إلى models.providers.google.baseUrl عند عدم تعيينه            model: "gemini-2.5-flash", // القيمة الافتراضية          },        },      },    },  },  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 لإنتاج إجابات مُولَّدة بالذكاء الاصطناعي مع استشهادات مضمنة. تتضمن النتائج كلًا من الإجابة المُولَّدة وعناوين URL للمصادر.

• تُحوَّل عناوين URL للاستشهادات الناتجة عن إسناد Gemini تلقائيًا من عناوين URL لإعادة التوجيه في Google إلى عناوين URL مباشرة عبر طلب HEAD من خلال مسار الجلب المحمي من SSRF في OpenClaw (اتباع عمليات إعادة التوجيه والتحقق من http/https).
• يستخدم حل عمليات إعادة التوجيه إعدادات 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 لإسناد بحث Google في Gemini. لا تُدعم 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؛ وتُحفظ مسارات الوكيل المخصصة كما قُدّمت بعد إزالة الشرطات المائلة اللاحقة.

ذو صلة

• نظرة عامة على البحث على الويب -- جميع الموفّرين والاكتشاف التلقائي
• بحث Brave -- نتائج منظّمة مع مقتطفات
• بحث Perplexity -- نتائج منظّمة + استخراج المحتوى