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

لتشغيل 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 إلى مفتاحين (أنشئ مفتاحًا).
• رصيد في حسابك (طرق الدفع).

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

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

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

1. 1

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

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

2. 2

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

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

3. 3

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

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

   تحقّق واحفظ#

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

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

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

كل مفتاح في خبير يعمل مع نماذج مزوّد واحد. فإذا وصل طلب لنموذج GPT بمفتاح Claude يعود بالخطأ MODEL_PLATFORM_NOT_ALLOWED.

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

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

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

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

# 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 معرّفًا من قائمة النماذج.

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

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

ابدأ بنموذج claude-sonnet-5.5 نموذجًا افتراضيًا للمحادثة. وأضف claude-opus-5.5 للأسئلة الطويلة والصعبة التي تستحق تكلفتها الأعلى. هذه نماذج Claude الحالية:

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

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

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

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

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

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

تُدفع كل رسالة من رصيدك حسب التوكنات التي تستخدمها، بسعر النموذج في خبير (الأسعار والرصيد). وفي النسخة المشتركة ينفق أشخاص كثيرون من المفاتيح نفسها، لذلك ضع الحدود على المفاتيح ذاتها. يمكنك التحكم في كل مفتاح: حد للإنفاق، وتاريخ انتهاء، وقائمة عناوين IP مسموح بها (التحكم في المفاتيح). وتفيدك كذلك مفاتيح خاصة بـ Open WebUI في فصل استخدامه عن أدواتك الأخرى في لوحة التحكم.

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

• INVALID_API_KEY أو الخطأ 401: المفتاح خطأ أو أُلغي. الصقه من جديد في الاتصال، أو راجع المتغيّر الذي مرّرته إلى Docker.
• MODEL_PLATFORM_NOT_ALLOWED: وصل النموذج إلى مفتاح مزوّد آخر. انقل المعرّف إلى الاتصال الذي يحمل المفتاح المطابق، واجعل كل قائمة Model IDs لمزوّد واحد.
• عنوان أساسي خطأ: استخدم https://api.5abeer.ai/v1، أي مع /v1 ودون أي شيء بعدها.
• النموذج غير موجود: في المعرّف خطأ كتابي أو تهجئة مختلفة. انسخه من قائمة النماذج.
• تغييرات البيئة لا تظهر بعد إعادة التشغيل: القيم المحفوظة من نوع PersistentConfig هي التي تفوز. عدّل الاتصال من شاشة المدير.
• INSUFFICIENT_BALANCE: رصيدك لا يكفي للطلب. اشحن الرصيد ثم أعد المحاولة.

كل رمز خطأ ومعناه في الأخطاء وحلولها.

أسئلة شائعة#

هل أستخدم اشتراكي في خبير داخل 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 يضيفها المستخدم من إعداداته. يشرح هذا الدليل اتصالات المدير، وفي النسخة المشتركة يسهل ضبط اتصالات المدير حين يكون لكل مفتاح حد إنفاق.

المصادر#

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

• وثائق Open WebUI: Quick Start وStarting with OpenAI وStarting with OpenAI-compatible servers وEnvironment variable configuration وHardening
• وثائق خبير: مفاتيح API والعناوين الأساسية والأخطاء وحلولها