OPENCLAW + GEMINI

استخدم Gemini في OpenClaw.

يتوفر Google Gemini عبر نقطة نهاية RunAPI المتوافقة مع OpenAI — Gemini 3.5 Flash للاستجابة الفائقة السرعة، وGemini 3.x Pro للاستدلال المعقد، وGemini 2.5 Pro لأعباء الإنتاج. يتعامل OpenClaw معه كأي نموذج آخر متوافق مع OpenAI، فمفتاح RUNAPI_API_KEY نفسه الذي يشغّل GPT يستدعي Gemini أيضاً. لا مشروع Google Cloud، ولا حساب خدمة، ولا إعداد Vertex AI.

مفتاح API واحد · نقطة نهاية دردشة متوافقة مع OpenAI · دعم البث
Use RunAPI to send a chat request to Google Gemini 3.5 Flash.

Requirements:
- Use the RunAPI OpenAI-compatible endpoint at https://runapi.ai/v1/chat/completions
- Set model to "gemini-3.5-flash"
- Use the RUNAPI_API_KEY environment variable for authorization
- The response is synchronous — the reply arrives in choices[0].message.content
- For streaming, set stream to true and process server-sent events
curl -X POST https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [
      {"role": "system", "content": "You are a concise technical assistant."},
      {"role": "user", "content": "Explain the difference between gRPC and REST in three sentences."}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gemini-3.5-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "gRPC uses HTTP/2 and Protocol Buffers for strongly-typed, multiplexed RPC calls with built-in code generation. REST uses HTTP/1.1 (or 2) with JSON payloads and relies on URL paths and HTTP verbs for resource semantics. gRPC is faster for service-to-service calls; REST is simpler to debug and more widely supported by browsers."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 34,
    "completion_tokens": 71,
    "total_tokens": 105
  }
}
انسخ أمر curl للاختبار gemini
HOW IT WORKS

استخدم Gemini في OpenClaw في ثلاث خطوات

1

هيّئ RunAPI

عيّن متغير البيئة RUNAPI_API_KEY. إن كنت قد هيّأت RunAPI مسبقاً كمزوّد في OpenClaw، فالمفتاح نفسه وbaseUrl يعملان مع Gemini — ما عليك سوى تغيير معرّف النموذج. لا حاجة لبيانات اعتماد Google Cloud.

export RUNAPI_API_KEY=runapi_xxx
2

استدعِ Gemini عبر إكمال الدردشة

أرسل طلب POST إلى /v1/chat/completions مع تعيين النموذج على gemini-3.5-flash. مرّر مصفوفة messages مع أدوار system وuser. تقبل نقطة النهاية الشكل المتوافق مع OpenAI الذي يستخدمه الوكيل مع نماذج GPT.

POST /v1/chat/completions
3

اقرأ الاستجابة

تصل الاستجابة بشكل متزامن بتنسيق إكمال دردشة OpenAI. رد المساعد موجود في choices[0].message.content، واستخدام الرموز في كائن usage. للبث، عيّن stream على true وحلّل أحداث SSE.

choices[0].message.content
PARAMETERS

معاملات واجهة برمجة إكمال دردشة Gemini

المعامل النوع الوصف
model string مطلوب. gemini-3.5-flash أو gemini-2.5-flash أو gemini-2.5-pro أو gemini-3-flash-preview أو gemini-3-pro-preview أو gemini-3.1-pro-preview.
messages array مطلوب. مصفوفة من كائنات الرسائل تحتوي على حقلَي role (system أو user أو assistant) وcontent.
temperature number اختياري. درجة حرارة أخذ العينات بين 0 و2. تنتج القيم المنخفضة مخرجات أكثر تحديداً. القيمة الافتراضية تختلف حسب النموذج.
max_tokens integer اختياري. الحد الأقصى لعدد الرموز المولَّدة في الاستجابة.
stream boolean اختياري. عند التعيين على true، تُبثّ الاستجابة كأحداث server-sent. يحتوي كل حدث على delta بمحتوى جزئي.
top_p number اختياري. عتبة أخذ عينات النواة بين 0 و1. بديل عن temperature للتحكم في عشوائية المخرجات.

ما هو Gemini في OpenClaw؟

Google Gemini متاح عبر RunAPI دون مشروع Google Cloud أو حساب خدمة أو إعداد Vertex AI. تستدعيه وكلاء OpenClaw عبر نقطة نهاية RunAPI chat completions — نفس المفتاح ونقطة النهاية للنماذج الأخرى.

حالات استخدام Gemini

تطبيقات متعددة الوسائط بالنص والصورة والصوت والفيديو

أرسل الصور وملفات PDF وملفات الصوت أو إطارات الفيديو جنباً إلى جنب مع النصوص التوجيهية للمهام متعددة الوسائط.

تحليل المستندات الطويلة بسياق مليون رمز

أدخل قواعد الأكواد الكاملة ومجموعات المستندات القانونية أو أوراق البحث في نافذة مليون رمز لـ Gemini.

حلقات الوكيل في الوقت الفعلي مع Flash

استخدم Gemini 3.5 Flash لحلقات استدعاء أدوات الوكيل الحساسة للسرعة حيث تُعدّ زمن الاستجابة.

FAQ

أسئلة حول Gemini و OpenClaw

إعداد OpenClaw العام

لم تُهيّئه بعد؟ ابدأ بدليل إعداد RunAPI لـ OpenClaw.

دليل إعداد OpenClaw →

كتالوج نماذج Gemini

اطّلع على جميع إصدارات Gemini وفئات الأسعار وتوثيق واجهة برمجة التطبيقات.

نماذج Gemini →

جرّب Gemini في OpenClaw اليوم.

احصل على مفتاح RunAPI مجاني، عيّن النموذج على gemini-3.5-flash في مزوّد OpenClaw، وابدأ الدردشة مع Gemini.