Google (Gemini)

يوفر Plugin Google إمكانية الوصول إلى نماذج Gemini عبر Google AI Studio، بالإضافة إلى توليد الصور، وفهم الوسائط (الصور/الصوت/الفيديو)، وتحويل النص إلى كلام، والبحث على الويب عبر Gemini Grounding.

• المزوّد: google
• المصادقة: GEMINI_API_KEY أو GOOGLE_API_KEY
• الواجهة البرمجية: Google Gemini API
• خيار التشغيل: المزوّد/النموذج agentRuntime.id: "google-gemini-cli" يعيد استخدام OAuth الخاص بـ Gemini CLI مع إبقاء مراجع النماذج معيارية بصيغة google/*.

البدء

اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.

openclaw onboard --auth-choice gemini-api-key

openclaw onboard --non-interactive \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY"

{  agents: {    defaults: {      model: { primary: "google/gemini-3.1-pro-preview" },    },  },}

openclaw models list --provider google

# Homebrewbrew install gemini-cli # or npmnpm install -g @google/gemini-cli

openclaw models auth login --provider google-gemini-cli --set-default

openclaw models list --provider google

الإمكانات

بحث الويب

يستخدم مزوّد بحث الويب gemini المضمن تأريض Gemini Google Search. هيّئ مفتاح بحث مخصصًا ضمن plugins.entries.google.config.webSearch، أو دعه يعيد استخدام models.providers.google.apiKey بعد GEMINI_API_KEY:

{  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", // falls back to models.providers.google.baseUrl            model: "gemini-2.5-flash",          },        },      },    },  },}

أسبقية بيانات الاعتماد هي webSearch.apiKey المخصص، ثم GEMINI_API_KEY، ثم models.providers.google.apiKey. يُعد webSearch.baseUrl اختياريًا وهو موجود لوكلاء المشغّل أو نقاط نهاية Gemini API المتوافقة؛ عند حذفه، يعيد بحث الويب في Gemini استخدام models.providers.google.baseUrl. راجع بحث Gemini لمعرفة سلوك الأداة الخاص بالمزوّد.

توليد الصور

يعتمد مزوّد توليد الصور google المضمن افتراضيًا على google/gemini-3.1-flash-image-preview.

• يدعم أيضًا google/gemini-3-pro-image-preview
• التوليد: حتى 4 صور لكل طلب
• وضع التحرير: مفعّل، حتى 5 صور إدخال
• عناصر التحكم الهندسية: size وaspectRatio وresolution

لاستخدام Google كمزوّد الصور الافتراضي:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "google/gemini-3.1-flash-image-preview",      },    },  },}

توليد الفيديو

يسجل Plugin google المضمن أيضًا توليد الفيديو عبر أداة video_generate المشتركة.

• نموذج الفيديو الافتراضي: google/veo-3.1-fast-generate-preview
• الأوضاع: تحويل النص إلى فيديو، وتحويل الصورة إلى فيديو، وتدفقات مرجع الفيديو الواحد
• يدعم aspectRatio (16:9، 9:16) وresolution (720P، 1080P)؛ إخراج الصوت غير مدعوم في Veo حاليًا
• المدد المدعومة: 4 أو 6 أو 8 ثوانٍ (تُقرَّب القيم الأخرى إلى أقرب قيمة مسموحة)

لاستخدام Google كمزوّد الفيديو الافتراضي:

{  agents: {    defaults: {      videoGenerationModel: {        primary: "google/veo-3.1-fast-generate-preview",      },    },  },}

توليد الموسيقى

يسجل Plugin google المضمن أيضًا توليد الموسيقى عبر أداة music_generate المشتركة.

• نموذج الموسيقى الافتراضي: google/lyria-3-clip-preview
• يدعم أيضًا google/lyria-3-pro-preview
• عناصر تحكم المطالبة: lyrics وinstrumental
• صيغة الإخراج: mp3 افتراضيًا، بالإضافة إلى wav على google/lyria-3-pro-preview
• إدخالات المراجع: حتى 10 صور
• تنفصل التشغيلات المدعومة بالجلسة عبر تدفق المهمة/الحالة المشترك، بما في ذلك action: "status"

لاستخدام Google كمزوّد الموسيقى الافتراضي:

{  agents: {    defaults: {      musicGenerationModel: {        primary: "google/lyria-3-clip-preview",      },    },  },}

تحويل النص إلى كلام

يستخدم مزوّد الكلام google المضمن مسار TTS في Gemini API مع gemini-3.1-flash-tts-preview.

• الصوت الافتراضي: Kore
• المصادقة: messages.tts.providers.google.apiKey أو models.providers.google.apiKey أو GEMINI_API_KEY أو GOOGLE_API_KEY
• الإخراج: WAV لمرفقات TTS العادية، وOpus لأهداف الملاحظات الصوتية، وPCM لـ Talk/الاتصالات الهاتفية
• إخراج الملاحظات الصوتية: يُغلَّف Google PCM كـ WAV ويُحوَّل إلى Opus بتردد 48 kHz باستخدام ffmpeg

يعيد مسار Gemini TTS الدفعي في Google الصوت المولّد في استجابة generateContent المكتملة. للمحادثات المنطوقة بأدنى زمن تأخير، استخدم مزوّد الصوت الفوري في Google المدعوم بـ Gemini Live API بدلًا من TTS الدفعي.

لاستخدام Google كمزوّد TTS الافتراضي:

{  messages: {    tts: {      auto: "always",      provider: "google",      providers: {        google: {          model: "gemini-3.1-flash-tts-preview",          speakerVoice: "Kore",          audioProfile: "Speak professionally with a calm tone.",        },      },    },  },}

يستخدم Gemini API TTS المطالبة باللغة الطبيعية للتحكم في الأسلوب. عيّن audioProfile لإضافة مطالبة أسلوب قابلة لإعادة الاستخدام قبل النص المنطوق. عيّن speakerName عندما يشير نص المطالبة إلى متحدث مسمّى.

يقبل Gemini API TTS أيضًا وسوم صوت تعبيرية بين أقواس مربعة في النص، مثل [whispers] أو [laughs]. لإبقاء الوسوم خارج رد الدردشة المرئي مع إرسالها إلى TTS، ضعها داخل كتلة [[tts:text]]...[[/tts:text]]:

Here is the clean reply text. [[tts:text]][whispers] Here is the spoken version.[[/tts:text]]

الصوت الفوري

يسجل Plugin google المضمن مزوّد صوت فوري مدعومًا بـ Gemini Live API لجسور الصوت الخلفية مثل Voice Call وGoogle Meet.

مثال على إعداد مكالمة صوتية في الوقت الفعلي:

{  plugins: {    entries: {      "voice-call": {        enabled: true,        config: {          realtime: {            enabled: true,            provider: "google",            providers: {              google: {                model: "gemini-2.5-flash-native-audio-preview-12-2025",                speakerVoice: "Kore",                activityHandling: "start-of-activity-interrupts",                turnCoverage: "only-activity",              },            },          },        },      },    },  },}

للتحقق المباشر الخاص بالمشرفين، شغّل OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts. يغطي اختبار الدخان أيضًا مسارات خلفية OpenAI/WebRTC؛ وينشئ جزء Google شكل رمز Live API المقيد نفسه المستخدم بواسطة Control UI Talk، ويفتح نقطة نهاية WebSocket في المتصفح، ويرسل حمولة الإعداد الأولية، وينتظر setupComplete.

الإعداد المتقدم

{  agents: {    defaults: {      models: {        "google/gemini-2.5-pro": {          params: {            cachedContent: "cachedContents/prebuilt-context",          },        },      },    },  },}

ذو صلة