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

بحث Gemini

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

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

1

إنشاء مفتاح

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

تخزين المفتاح

اضبط GEMINI_API_KEY في بيئة Gateway، أو قم بالتهيئة عبر:
openclaw configure --section web

التكوين

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // optional if GEMINI_API_KEY is set
            model: "gemini-2.5-flash", // default
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
بديل البيئة: اضبط GEMINI_API_KEY في بيئة Gateway. بالنسبة إلى تثبيت gateway، ضعه في ~/.openclaw/.env.

كيف يعمل

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

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

يدعم بحث Gemini المعلمة query. يُقبل count من أجل التوافق مع web_search المشترك، لكن استناد Gemini لا يزال يعيد إجابة مركبة واحدة مع استشهادات بدلًا من قائمة من N نتائج. لا يتم دعم عوامل التصفية الخاصة بالموفر مثل country وlanguage وfreshness و domain_filter.

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

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

ذو صلة