استخدم 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.
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
}
}
استخدم Gemini في OpenClaw في ثلاث خطوات
هيّئ RunAPI
عيّن متغير البيئة RUNAPI_API_KEY. إن كنت قد هيّأت RunAPI مسبقاً كمزوّد في OpenClaw، فالمفتاح نفسه وbaseUrl يعملان مع Gemini — ما عليك سوى تغيير معرّف النموذج. لا حاجة لبيانات اعتماد Google Cloud.
export RUNAPI_API_KEY=runapi_xxx
استدعِ Gemini عبر إكمال الدردشة
أرسل طلب POST إلى /v1/chat/completions مع تعيين النموذج على gemini-3.5-flash. مرّر مصفوفة messages مع أدوار system وuser. تقبل نقطة النهاية الشكل المتوافق مع OpenAI الذي يستخدمه الوكيل مع نماذج GPT.
POST /v1/chat/completions
اقرأ الاستجابة
تصل الاستجابة بشكل متزامن بتنسيق إكمال دردشة OpenAI. رد المساعد موجود في choices[0].message.content، واستخدام الرموز في كائن usage. للبث، عيّن stream على true وحلّل أحداث SSE.
choices[0].message.content
معاملات واجهة برمجة إكمال دردشة 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 لحلقات استدعاء أدوات الوكيل الحساسة للسرعة حيث تُعدّ زمن الاستجابة.
أسئلة حول Gemini و OpenClaw
نعم. يوفّر RunAPI الوصول إلى Gemini عبر نقطة نهايته المتوافقة مع OpenAI. تحتاج فقط إلى RUNAPI_API_KEY — لا مشروع Google Cloud، ولا ملف JSON لحساب الخدمة، ولا إعداد فواتير Vertex AI.
يوفّر RunAPI 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. مرّر مُعرّف الإصدار كمعامل model — مثلاً gemini-3.5-flash أو gemini-2.5-pro.
يُحسَب Gemini بالرمز على RunAPI بتسعير الدفع حسب الاستخدام. تُحتسب رموز الإدخال والإخراج بشكل منفصل. لا اشتراك شهري، ولا حد أدنى للإنفاق. راجع صفحة تسعير RunAPI للاطلاع على الأسعار الحالية لكل مليون رمز.
نعم. كلاهما يستخدم إعداد مزوّد RunAPI والمفتاح نفسه. غيّر معامل model من gemini-3.5-flash إلى gpt-5.5 (أو أي نموذج RunAPI آخر) دون إعادة تهيئة المزوّد. يختار OpenClaw النماذج لكل طلب على حدة.
نعم. عيّن stream على true في جسم الطلب. يبثّ RunAPI استجابات Gemini كأحداث server-sent بتنسيق delta المتوافق مع OpenAI، فيعالجها OpenClaw بالطريقة نفسها التي يتعامل بها مع بث GPT.
كتالوج نماذج Gemini
اطّلع على جميع إصدارات Gemini وفئات الأسعار وتوثيق واجهة برمجة التطبيقات.
نماذج Gemini →جرّب Gemini في OpenClaw اليوم.
احصل على مفتاح RunAPI مجاني، عيّن النموذج على gemini-3.5-flash في مزوّد OpenClaw، وابدأ الدردشة مع Gemini.