# تشغيل Open WebUI بنماذج Claude وGPT عبر مفاتيح خبير

> اربط Open WebUI بخبير: اتصال متوافق مع OpenAI لكل مفتاح، والعنوان الأساسي /v1، وقائمة Model IDs محددة، من الواجهة أو بمتغيرات البيئة.

آخر تحديث: 2026-11-01

لتشغيل Open WebUI بنماذج Claude وGPT عبر خبير، افتح Settings > Admin > Connections وأضف اتصال OpenAI لكل مفتاح API من خبير. يستخدم كل اتصال العنوان `https://api.5abeer.ai/v1` ومفتاحه الخاص، مع قائمة Model IDs فيها معرّفات المزوّد الخاص به فقط، مثل `claude-sonnet-5.5` في اتصال Claude. وتُدفع كل الطلبات من رصيدك في خبير.

## ما تحتاج إليه

- نسخة من Open WebUI تستضيفها أنت أو فريقك، مع حساب مدير.
- مفتاح API من خبير لكل مزوّد تريده في المحادثة. فالمفتاح يعمل مع نماذج مزوّد واحد فقط، ولذلك يحتاج Claude وGPT إلى مفتاحين ([أنشئ مفتاحًا](https://5abeer.ai/ar/docs/start/keys.md#create)).
- رصيد في حسابك ([طرق الدفع](https://5abeer.ai/ar/docs/start/payment.md)).

مفتاح الاشتراك في خبير لا يعمل هنا. فالباقات مخصّصة للتطبيقات المدعومة، وOpen WebUI ليس منها. لاستخدام النماذج في Open WebUI أنشئ مفتاح API يُدفع استخدامه من رصيدك.

يقدّم خبير صيغة OpenAI Chat Completions على المسار `/v1` لنماذج Claude وGPT وGemini، فيكفي نوع اتصال OpenAI في Open WebUI لها جميعًا:

| الصيغة | العنوان الأساسي | ترويسة المفتاح |
| --- | --- | --- |
| OpenAI | `https://api.5abeer.ai/v1` | `Authorization: Bearer <KEY>` |
| Anthropic | `https://api.5abeer.ai` | `x-api-key: <KEY>` |
| Gemini | `https://api.5abeer.ai/v1beta` | `x-goog-api-key: <KEY>` |

## إضافة API متوافق مع OpenAI في Open WebUI

### 1. أنشئ مفتاح API في خبير

افتح في لوحة التحكم **API → Keys**، واختر **New key**، ثم حدّد المزوّد. ابدأ بـ Claude. انسخ المفتاح عندما يظهر.

### 2. افتح قائمة الاتصالات

ادخل إلى Open WebUI بحساب المدير، ثم انتقل إلى **Settings > Admin > Connections**. ابحث عن القائمة **Manage OpenAI API Connections** واضغط **Add Connection** (زر ➕).

### 3. املأ بيانات الاتصال

- **Connection Type**: اختر External.
- **URL**: `https://api.5abeer.ai/v1`
- **API Key**: مفتاح Claude من خبير.
- **Model IDs** (تحت **Advanced**): اكتب `claude-sonnet-5.5` واضغط **+**، ثم أضف `claude-opus-5.5` بالطريقة نفسها. انسخ كل معرّف من [قائمة النماذج](https://5abeer.ai/ar/models).
- **Prefix ID**: اختياري. فالبادئة `khabeer` مثلًا تُظهر النموذج باسم `khabeer.claude-sonnet-5.5`، ثم يحذفها Open WebUI قبل إرسال الطلب.
- **Provider** (تحت **Advanced**): اتركه على **Default**.

### 4. تحقّق واحفظ

اضغط **Verify Connection** ثم **Save**. افتح محادثة جديدة، واختر النموذج من قائمة النماذج، وأرسل رسالة قصيرة. إذا وصلك رد فالاتصال يعمل.

توضّح وثائق Open WebUI أهمية قائمة Model IDs: فعندما تملؤها يتوقف عن طلب `/models` من المزوّد، ويعرض المعرّفات التي كتبتها فقط. وعندما تتركها فارغة يجلب القائمة من الاتصال نفسه. ونحن لا نَعِد بأن هذه القائمة تُصفّى حسب المفتاح، لذلك املأ Model IDs في كل اتصال بخبير.

## مفاتيح API متعددة في Open WebUI: Claude وGPT معًا

كل مفتاح في خبير يعمل مع نماذج مزوّد واحد. فإذا وصل طلب لنموذج GPT بمفتاح Claude يعود بالخطأ [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED).

لذلك أضف اتصالًا لكل مفتاح، وكلها بالعنوان نفسه:

| الاتصال | URL | API Key | Model IDs |
| --- | --- | --- | --- |
| Claude | `https://api.5abeer.ai/v1` | مفتاح Claude | `claude-sonnet-5.5` و`claude-opus-5.5` |
| GPT | `https://api.5abeer.ai/v1` | مفتاح GPT | `YOUR_GPT_MODEL_ID` (انسخ المعرّف من قائمة النماذج) |
| Gemini (اختياري) | `https://api.5abeer.ai/v1` | مفتاح Gemini | `YOUR_GEMINI_MODEL_ID` (انسخ المعرّف من قائمة النماذج) |

ضع كل معرّف في اتصال واحد فقط. تذكر وثائق Open WebUI أنه يُبقي نموذجًا واحدًا لكل معرّف عند غياب البادئة، فإذا أعاد اتصالان المعرّف نفسه عرض نسخة الاتصال الأعلى في القائمة وحدها. والقائمة المحددة لكل مفتاح تُبقي كل طلب على المفتاح الصحيح. ولكل اتصال مفتاح تشغيل وإيقاف، فيمكنك تعطيله دون حذفه. ويُخصم استخدام كل المفاتيح من الرصيد نفسه.

## إعدادات OpenAI API في Open WebUI عبر Docker

هذا هو الأمر الافتراضي من دليل البدء السريع، مع الاتصالين نفسيهما في متغيرات البيئة:

```bash
# Export the keys in your shell or load them from a secret store first:
# KHABEER_CLAUDE_KEY, KHABEER_GPT_KEY, WEBUI_SECRET_KEY
docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY="$WEBUI_SECRET_KEY" \
  -e OPENAI_API_BASE_URLS="https://api.5abeer.ai/v1;https://api.5abeer.ai/v1" \
  -e OPENAI_API_KEYS="$KHABEER_CLAUDE_KEY;$KHABEER_GPT_KEY" \
  -e OPENAI_API_CONFIGS='{"0":{"enable":true,"model_ids":["claude-sonnet-5.5","claude-opus-5.5"]},"1":{"enable":true,"model_ids":["YOUR_GPT_MODEL_ID"]}}' \
  -e ENABLE_SIGNUP=false \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main
```

- تُفصل القيم في `OPENAI_API_BASE_URLS` وفي `OPENAI_API_KEYS` بفاصلة منقوطة. حافظ على الترتيب نفسه في القائمتين، فالمفتاح الأول للعنوان الأول.
- يعتمد `OPENAI_API_CONFIGS` على رقم ترتيب الاتصال في `OPENAI_API_BASE_URLS`، ويقبل إعدادات كل اتصال كما في شاشة المدير، مثل `enable` و`prefix_id` و`model_ids`.
- ضع مكان `YOUR_GPT_MODEL_ID` معرّفًا من [قائمة النماذج](https://5abeer.ai/ar/models).

هذه الإعدادات من نوع PersistentConfig (أي `ConfigVar`). يقرؤها Open WebUI عند التشغيل الأول ويحفظها، وبعد إعادة التشغيل يستخدم القيم المحفوظة لا قيم البيئة. لتغيير اتصال لاحقًا عدّله من شاشة المدير. وإذا أردت أن تفوز قيم البيئة في كل تشغيل فاضبط `ENABLE_PERSISTENT_CONFIG=false`، لكن التعديلات من شاشة المدير تضيع حينها عند إعادة التشغيل.

## أي نموذج Claude تختار في Open WebUI؟

ابدأ بنموذج [`claude-sonnet-5.5`](https://5abeer.ai/ar/models/claude-sonnet-5.5) نموذجًا افتراضيًا للمحادثة. وأضف [`claude-opus-5.5`](https://5abeer.ai/ar/models/claude-opus-5.5) للأسئلة الطويلة والصعبة التي تستحق تكلفتها الأعلى. هذه نماذج Claude الحالية:

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| Claude Sonnet 5.5 | `claude-sonnet-5.5` | 0.60 US$ | 3 US$ | 1M |
| Claude Opus 5.5 | `claude-opus-5.5` | 1.20 US$ | 6 US$ | 1M |
| Claude Fable 5.1 | `claude-fable-5.1` | 3 US$ | 15 US$ | — |

السعر الرسمي بجانب سعرنا، مع تاريخ قراءته:

Claude Sonnet 5.5 (`claude-sonnet-5.5`) لكل مليون توكن: الإدخال 0.60 US$ (الرسمي 2 US$)، الإخراج 3 US$ (الرسمي 10 US$). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

ولاتصالَي GPT وGemini خذ المعرّفات من هاتين القائمتين:

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| GPT-6.1 Sol | `gpt-6.1-sol` | 0.60 US$ | 3 US$ | 922K |
| GPT-6 Astra | `gpt-6-astra` | 3 US$ | 15 US$ | — |
| GPT-6 Sol | `gpt-6-sol` | 0.60 US$ | 3 US$ | 922K |

| النموذج | المعرّف | الإدخال (سعرنا) | الإخراج (سعرنا) | السياق |
| --- | --- | --- | --- | --- |
| Gemini 4 Argon | `gemini-4-argon` | 0.60 US$ | 3 US$ | — |
| Gemini 2.5 Pro | `gemini-2.5-pro` | 0.38 US$ | 3 US$ | 1M |

## تأمين نسخة Open WebUI المستضافة ذاتيًا

عندما تستضيف Open WebUI بنفسك فأنت المسؤول عن التحكم في الوصول إليه. فكل من يستطيع الدخول يمكنه الإنفاق من المفاتيح المربوطة باتصالاته.

- أغلق التسجيل بالمتغيّر `ENABLE_SIGNUP=false`، أو أبقِ `DEFAULT_USER_ROLE=pending`، وهي القيمة الافتراضية، حتى يوافق المدير على كل حساب جديد.
- قدّم الخدمة عبر HTTPS. لا يتولّى Open WebUI تشفير TLS بنفسه، ويضعه دليل التأمين خلف خادم وكيل عكسي مثل Nginx أو Caddy.
- احفظ المفاتيح و`WEBUI_SECRET_KEY` في متغيرات البيئة أو في مخزن أسرار، ولا تضعها أبدًا في ملف يُرفع إلى المستودع.

## التحكم في تكلفة Open WebUI

تُدفع كل رسالة من رصيدك حسب التوكنات التي تستخدمها، بسعر النموذج في خبير ([الأسعار والرصيد](https://5abeer.ai/ar/docs/start/pricing.md)). وفي النسخة المشتركة ينفق أشخاص كثيرون من المفاتيح نفسها، لذلك ضع الحدود على المفاتيح ذاتها. يمكنك التحكم في كل مفتاح: حد للإنفاق، وتاريخ انتهاء، وقائمة عناوين IP مسموح بها ([التحكم في المفاتيح](https://5abeer.ai/ar/docs/start/keys.md#controls)). وتفيدك كذلك مفاتيح خاصة بـ Open WebUI في فصل استخدامه عن أدواتك الأخرى في لوحة التحكم.

## الأخطاء الشائعة وحلولها

- [`INVALID_API_KEY`](https://5abeer.ai/ar/docs/help/errors.md#INVALID_API_KEY) أو الخطأ 401: المفتاح خطأ أو أُلغي. الصقه من جديد في الاتصال، أو راجع المتغيّر الذي مرّرته إلى Docker.
- [`MODEL_PLATFORM_NOT_ALLOWED`](https://5abeer.ai/ar/docs/help/errors.md#MODEL_PLATFORM_NOT_ALLOWED): وصل النموذج إلى مفتاح مزوّد آخر. انقل المعرّف إلى الاتصال الذي يحمل المفتاح المطابق، واجعل كل قائمة Model IDs لمزوّد واحد.
- عنوان أساسي خطأ: استخدم `https://api.5abeer.ai/v1`، أي مع `/v1` ودون أي شيء بعدها.
- النموذج غير موجود: في المعرّف خطأ كتابي أو تهجئة مختلفة. انسخه من [قائمة النماذج](https://5abeer.ai/ar/models).
- تغييرات البيئة لا تظهر بعد إعادة التشغيل: القيم المحفوظة من نوع PersistentConfig هي التي تفوز. عدّل الاتصال من شاشة المدير.
- [`INSUFFICIENT_BALANCE`](https://5abeer.ai/ar/docs/help/errors.md#INSUFFICIENT_BALANCE): رصيدك لا يكفي للطلب. اشحن الرصيد ثم أعد المحاولة.

كل رمز خطأ ومعناه في [الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md).

## أسئلة شائعة

### هل أستخدم اشتراكي في خبير داخل Open WebUI؟

لا. الباقات تشغّل التطبيقات المدعومة فقط، وOpen WebUI ليس منها. أنشئ مفتاح API وادفع استخدام Open WebUI من رصيدك.

### كيف أستخدم Claude في Open WebUI؟

أضف اتصال OpenAI بالعنوان `https://api.5abeer.ai/v1` ومفتاح Claude من خبير، ثم اكتب معرّفات Claude في Model IDs. تظهر نماذج Claude بعدها في قائمة النماذج بجانب نماذجك الأخرى.

### لماذا أحتاج إلى مفتاحين لـ Claude وGPT؟

لأن المفتاح في خبير يعمل مع نماذج مزوّد واحد فقط. أنشئ مفتاحًا لكل مزوّد، وأضف اتصالًا لكل مفتاح. ويستخدم الاتصالان العنوان نفسه والرصيد نفسه.

### هل أحتاج إلى Prefix ID؟

لا. معرّفات خبير تختلف من مزوّد إلى آخر، فلا تتعارض. والبادئة تغيّر فقط اسم النموذج داخل Open WebUI، مثل `khabeer.claude-sonnet-5.5`.

### لماذا لم يُطبَّق تغيير متغيّر البيئة؟

لأن إعدادات الاتصال من نوع PersistentConfig. يحفظها Open WebUI عند التشغيل الأول، ثم يستخدم النسخة المحفوظة بعد ذلك. غيّرها من شاشة المدير، أو اضبط `ENABLE_PERSISTENT_CONFIG=false`.

### هل يستطيع كل مستخدم إضافة مفتاحه الخاص؟

في Open WebUI أيضًا اتصالات شخصية باسم **Direct Connections** يضيفها المستخدم من إعداداته. يشرح هذا الدليل اتصالات المدير، وفي النسخة المشتركة يسهل ضبط اتصالات المدير حين يكون لكل مفتاح حد إنفاق.

> هل أنت مستعد لربط Open WebUI؟ [أنشئ مفتاح API](https://5abeer.ai/ar/docs/start/keys.md#create) لكل مزوّد تريده، ثم راجع كل النماذج وأسعارها في [صفحة API في خبير](https://5abeer.ai/ar/api). وإذا كنت تُعدّ تطبيق محادثة مشابهًا فراجع دليل [LibreChat](https://5abeer.ai/ar/guides/librechat-api-key)، أو اقرأ [الاشتراك أم API](https://5abeer.ai/ar/guides/ai-subscription-vs-api).

## المصادر

راجعناها في 2026-11-01:

- وثائق Open WebUI: [Quick Start](https://docs.openwebui.com/getting-started/quick-start/) و[Starting with OpenAI](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai) و[Starting with OpenAI-compatible servers](https://docs.openwebui.com/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible) و[Environment variable configuration](https://docs.openwebui.com/reference/env-configuration) و[Hardening](https://docs.openwebui.com/getting-started/advanced-topics/hardening)
- وثائق خبير: [مفاتيح API](https://5abeer.ai/ar/docs/start/keys.md) و[العناوين الأساسية](https://5abeer.ai/ar/docs/start/base-urls.md) و[الأخطاء وحلولها](https://5abeer.ai/ar/docs/help/errors.md)

> خبير خدمة مستقلة، ولا تتبع Open WebUI أو OpenAI أو Anthropic أو Google.