---
title: "استخدام Gemini في OpenClaw عبر RunAPI — دليل واجهة برمجة النماذج اللغوية"
url: "https://runapi.ai/ar/openclaw-gemini.md"
canonical: "https://runapi.ai/ar/openclaw-gemini"
locale: "ar"
model: "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 example

```bash
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
  }'

```

### Response

```json
{
  "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
  }
}

```

## How it works

1. **هيّئ RunAPI** — عيّن متغير البيئة RUNAPI_API_KEY. إن كنت قد هيّأت RunAPI مسبقاً كمزوّد في OpenClaw، فالمفتاح نفسه وbaseUrl يعملان مع Gemini — ما عليك سوى تغيير معرّف النموذج. لا حاجة لبيانات اعتماد Google Cloud.
2. **استدعِ Gemini عبر إكمال الدردشة** — أرسل طلب POST إلى /v1/chat/completions مع تعيين النموذج على gemini-3.5-flash. مرّر مصفوفة messages مع أدوار system وuser. تقبل نقطة النهاية الشكل المتوافق مع OpenAI الذي يستخدمه الوكيل مع نماذج GPT.
3. **اقرأ الاستجابة** — تصل الاستجابة بشكل متزامن بتنسيق إكمال دردشة OpenAI. رد المساعد موجود في choices[0].message.content، واستخدام الرموز في كائن usage. للبث، عيّن stream على true وحلّل أحداث SSE.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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 للتحكم في عشوائية المخرجات. |

## FAQ

### هل يمكنني استخدام Google Gemini في OpenClaw دون مشروع Google Cloud؟

نعم. يوفّر RunAPI الوصول إلى Gemini عبر نقطة نهايته المتوافقة مع OpenAI. تحتاج فقط إلى RUNAPI_API_KEY — لا مشروع Google Cloud، ولا ملف JSON لحساب الخدمة، ولا إعداد فواتير Vertex AI.

### ما نماذج Gemini المتاحة عبر RunAPI؟

يوفّر 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؟

يُحسَب Gemini بالرمز على RunAPI بتسعير الدفع حسب الاستخدام. تُحتسب رموز الإدخال والإخراج بشكل منفصل. لا اشتراك شهري، ولا حد أدنى للإنفاق. راجع صفحة تسعير RunAPI للاطلاع على الأسعار الحالية لكل مليون رمز.

### هل يمكنني التبديل بين Gemini وGPT في جلسة OpenClaw نفسها؟

نعم. كلاهما يستخدم إعداد مزوّد RunAPI والمفتاح نفسه. غيّر معامل model من gemini-3.5-flash إلى gpt-5.5 (أو أي نموذج RunAPI آخر) دون إعادة تهيئة المزوّد. يختار OpenClaw النماذج لكل طلب على حدة.

### هل يدعم Gemini عبر RunAPI استجابات البث؟

نعم. عيّن stream على true في جسم الطلب. يبثّ RunAPI استجابات Gemini كأحداث server-sent بتنسيق delta المتوافق مع OpenAI، فيعالجها OpenClaw بالطريقة نفسها التي يتعامل بها مع بث GPT.


## Links

- [دليل إعداد OpenClaw →](https://runapi.ai/ar/openclaw)
- [نماذج Gemini →](https://runapi.ai/ar/models/gemini)
- [Model catalog](https://runapi.ai/ar/models)
- [API docs](https://runapi.ai/ar/docs)