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

​
Google ‏(Gemini)

يوفر plugin ‏Google الوصول إلى نماذج Gemini عبر Google AI Studio، بالإضافة إلى توليد الصور، وفهم الوسائط (الصورة/الصوت/الفيديو)، والبحث على الويب عبر Gemini Grounding.
  • المزوّد: google
  • المصادقة: GEMINI_API_KEY أو GOOGLE_API_KEY
  • API: ‏Google Gemini API
  • مزوّد بديل: google-gemini-cli ‏(OAuth)

​
البدء السريع

  1. عيّن مفتاح API:
openclaw onboard --auth-choice gemini-api-key
  1. عيّن نموذجًا افتراضيًا:
{
  agents: {
    defaults: {
      model: { primary: "google/gemini-3.1-pro-preview" },
    },
  },
}

​
مثال غير تفاعلي

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

​
OAuth ‏(Gemini CLI)

يستخدم المزوّد البديل google-gemini-cli بروتوكول PKCE OAuth بدلًا من مفتاح API. وهذا تكامل غير رسمي؛ وقد أبلغ بعض المستخدمين عن وجود قيود على الحساب. استخدمه على مسؤوليتك الخاصة.
  • النموذج الافتراضي: google-gemini-cli/gemini-3.1-pro-preview
  • الاسم المستعار: gemini-cli
  • متطلب التثبيت: توفر Gemini CLI محليًا باسم gemini
    • Homebrew: ‏brew install gemini-cli
    • npm: ‏npm install -g @google/gemini-cli
  • تسجيل الدخول:
openclaw models auth login --provider google-gemini-cli --set-default
متغيرات البيئة:
  • OPENCLAW_GEMINI_OAUTH_CLIENT_ID
  • OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET
(أو متغيرات GEMINI_CLI_* المكافئة.) إذا فشلت طلبات Gemini CLI OAuth بعد تسجيل الدخول، فعيّن GOOGLE_CLOUD_PROJECT أو GOOGLE_CLOUD_PROJECT_ID على مضيف gateway ثم أعد المحاولة. إذا فشل تسجيل الدخول قبل بدء تدفق المتصفح، فتأكد من أن الأمر المحلي gemini مثبّت وموجود في PATH. يدعم OpenClaw كلًا من تثبيتات Homebrew وتثبيتات npm العامة، بما في ذلك تخطيطات Windows/npm الشائعة. ملاحظات استخدام JSON في Gemini CLI:
  • يأتي نص الرد من الحقل response في JSON الخاص بـ CLI.
  • يعود الاستخدام إلى stats عندما تترك CLI قيمة usage فارغة.
  • يتم تطبيع stats.cached إلى cacheRead في OpenClaw.
  • إذا كانت stats.input مفقودة، يشتق OpenClaw رموز الإدخال من stats.input_tokens - stats.cached.

​
القدرات

القدرةمدعومة
إكمالات الدردشةنعم
توليد الصورنعم
فهم الصورنعم
نسخ الصوتنعم
فهم الفيديونعم
البحث على الويب (Grounding)نعم
التفكير/الاستدلالنعم (Gemini 3.1+)

​
إعادة استخدام ذاكرة Gemini المؤقتة مباشرة

بالنسبة إلى تشغيلات Gemini API المباشرة (api: "google-generative-ai")، يمرر OpenClaw الآن المقبض cachedContent المكوَّن إلى طلبات Gemini.
  • كوّن المعلمات لكل نموذج أو عالميًا باستخدام cachedContent أو الصيغة القديمة cached_content
  • إذا وُجد الاثنان، فإن cachedContent هي الفائزة
  • مثال على القيمة: cachedContents/prebuilt-context
  • يتم تطبيع استخدام إصابة ذاكرة Gemini المؤقتة إلى cacheRead في OpenClaw من cachedContentTokenCount الصادر من المصدر
مثال: 
{
  agents: {
    defaults: {
      models: {
        "google/gemini-2.5-pro": {
          params: {
            cachedContent: "cachedContents/prebuilt-context",
          },
        },
      },
    },
  },
}

​
توليد الصور

يعتمد مزود توليد الصور google المضمّن افتراضيًا على google/gemini-3.1-flash-image-preview.
  • يدعم أيضًا google/gemini-3-pro-image-preview
  • التوليد: حتى 4 صور لكل طلب
  • وضع التحرير: مفعّل، حتى 5 صور إدخال
  • عناصر التحكم الهندسية: size وaspectRatio وresolution
يمثل المزوّد google-gemini-cli المعتمد على OAuth فقط سطحًا منفصلًا للاستدلال النصي. أما توليد الصور، وفهم الوسائط، وGemini Grounding فتبقى على معرّف المزوّد google.

​
ملاحظة حول البيئة

إذا كانت Gateway تعمل كـ daemon ‏(launchd/systemd)، فتأكد من أن GEMINI_API_KEY متاح لتلك العملية (مثلًا، في ~/.openclaw/.env أو عبر env.shellEnv).