إعداد LibreChat بمفتاح خبير: نقاط اتصال مخصّصة

لإعداد LibreChat بمفتاح خبير، أضف نقطة اتصال مخصّصة لكل مزوّد تحت endpoints.custom في الملف librechat.yaml. ضع في baseURL العنوان https://api.5abeer.ai/v1، واجعل apiKey يقرأ المفتاح من متغيّر في .env، واكتب معرّف نموذج مثل claude-sonnet-5.5 تحت models.default، ثم أعد تشغيل LibreChat. بعد ذلك تُدفع الطلبات من رصيدك في خبير.

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

• نسخة من LibreChat تستضيفها بنفسك. تفترض الأمثلة التالية التثبيت عبر Docker Compose.
• مفتاح API من خبير لكل مزوّد تريده. فالمفتاح يعمل مع نماذج مزوّد واحد فقط، ومفتاح Claude يشغّل نماذج Claude وحدها (أنشئ مفتاحًا).
• رصيد في حسابك (طرق الدفع).

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

كيف تعمل نقاط الاتصال المخصّصة في LibreChat؟#

يقرأ LibreChat المزوّدين الإضافيين من الملف librechat.yaml. وكل عنصر تحت endpoints.custom اتصال متوافق مع OpenAI، له اسمه ومفتاحه وعنوانه الأساسي وقائمة نماذجه، ويظهر خيارًا مستقلًا في قائمة نقاط الاتصال.

تذكر وثائق LibreChat أربعة حقول إلزامية: name وapiKey وbaseURL وmodels. وتنبّه إلى أن غياب أي منها يُسقط نقطة الاتصال بصمت، دون أي خطأ في السجلات. ويقدّم خبير صيغة OpenAI Chat Completions على المسار /v1 لنماذج Claude وGPT وGemini، فتكفي نقطة اتصال واحدة لكل مفتاح.

مثال librechat.yaml لخبير#

1. 1

   أنشئ مفتاحًا لكل مزوّد#

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

2. 2

   ضع المفاتيح في .env#

   أضف متغيّرًا لكل مفتاح في الملف .env داخل مجلد LibreChat. الأسماء من اختيارك، ويكفي أن تطابق ما تكتبه في librechat.yaml.

   .envانسخ

   KHABEER_CLAUDE_KEY=your-5abeer-claude-key
   KHABEER_GPT_KEY=your-5abeer-gpt-key
   KHABEER_GEMINI_KEY=your-5abeer-gemini-key

3. 3

   اكتب الملف librechat.yaml#

   أنشئ الملف librechat.yaml بجانب docker-compose.yml. ولنماذج GPT وGemini انسخ المعرّف من قائمة النماذج وضعه مكان القيمة المؤقتة.

   librechat.yamlانسخ

   version: 1.3.18
   endpoints:
     custom:
       - name: '5abeer Claude'
         apiKey: '${KHABEER_CLAUDE_KEY}'
         baseURL: 'https://api.5abeer.ai/v1'
         models:
           default: ['claude-sonnet-5.5', 'claude-opus-5.5']
           fetch: false
         titleConvo: true
         titleModel: 'current_model'
         modelDisplayLabel: '5abeer Claude'
       - name: '5abeer GPT'
         apiKey: '${KHABEER_GPT_KEY}'
         baseURL: 'https://api.5abeer.ai/v1'
         models:
           default: ['YOUR_GPT_MODEL_ID']
           fetch: false
         titleConvo: true
         titleModel: 'current_model'
         modelDisplayLabel: '5abeer GPT'
       - name: '5abeer Gemini'
         apiKey: '${KHABEER_GEMINI_KEY}'
         baseURL: 'https://api.5abeer.ai/v1'
         models:
           default: ['YOUR_GEMINI_MODEL_ID']
           fetch: false
         titleConvo: true
         titleModel: 'current_model'
         modelDisplayLabel: '5abeer Gemini'

   قيمة version هي إصدار مخطط الإعداد كما يظهر في دليل البدء السريع من LibreChat. وإذا جاء إصدارك من LibreChat بقيمة أحدث فاستخدمها. واحذف كتلة Gemini إن لم تحتج إليها.

4. 4

   اربط الملف عبر docker-compose.override.yml#

   لا تقرأ حاوية LibreChat الملف قبل أن تربطه بها. أضف ما يلي إلى docker-compose.override.yml:

   docker-compose.override.ymlانسخ

   services:
     api:
       volumes:
         - type: bind
           source: ./librechat.yaml
           target: /app/librechat.yaml

5. 5

   أعد التشغيل وجرّب#

   يقرأ LibreChat الإعداد عند التشغيل، لذلك أعد تشغيله بعد كل تعديل:

   Terminalانسخ

   docker compose down && docker compose up -d

   افتح LibreChat، واختر 5abeer Claude من قائمة نقاط الاتصال، ثم النموذج claude-sonnet-5.5، وأرسل رسالة قصيرة. إذا وصلك رد فالإعداد يعمل.

وظيفة كل حقل:

• name: اسم فريد يظهر عنوانًا في قائمة نقاط الاتصال.
• apiKey: المفتاح. الصيغة '${KHABEER_CLAUDE_KEY}' تقرؤه من .env، فلا يُكتب المفتاح في ملف YAML أبدًا.
• baseURL: العنوان https://api.5abeer.ai/v1 لكل نقاط الاتصال.
• models.default: المعرّفات التي تظهر في قائمة النماذج. ضع claude-sonnet-5.5 أولًا.
• models.fetch: القيمة false تُبقي القائمة التي كتبتها. اكتب كل معرّف كما يظهر في قائمة النماذج تمامًا.
• titleConvo وtitleModel: يفعّلان عناوين المحادثات، والقيمة 'current_model' تكتب العنوان بنموذج المحادثة نفسها.
• modelDisplayLabel: التسمية التي تظهر بجانب أيقونة النموذج.

LibreChat مع Claude: نقطة اتصال Anthropic المدمجة#

في LibreChat أيضًا نقطة اتصال مدمجة لـ Anthropic تُضبط من .env. ويذكر مرجع المتغيّرات فيها ANTHROPIC_API_KEY وANTHROPIC_MODELS وANTHROPIC_REVERSE_PROXY، ويصف الأخير بأنه وسيط عكسي لـ Anthropic. فإذا استخدمت مفتاح Claude من خبير فاجعل الوسيط العكسي عنوان صيغة Anthropic، وهو بلا /v1:

ANTHROPIC_API_KEY=your-5abeer-claude-key
ANTHROPIC_REVERSE_PROXY=https://api.5abeer.ai
ANTHROPIC_MODELS=claude-sonnet-5.5,claude-opus-5.5

يستخدم هذا الطريق صيغة Anthropic Messages. اختر طريقًا واحدًا لـ Claude، نقطة الاتصال المخصّصة أو هذا الطريق، حتى لا يرى مستخدموك النماذج نفسها مرتين.

أي نموذج تختار في LibreChat؟#

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

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

ولنقطتي GPT وGemini خذ المعرّفات من القائمتين التاليتين، مع مفتاح لذلك المزوّد:

Claude وGPT وGemini في LibreChat واحد: مفتاح لكل مزوّد#

كل مفتاح في خبير يعمل مع نماذج مزوّد واحد. فإذا وضعت معرّف GPT تحت نقطة Claude يعود الطلب بالخطأ MODEL_PLATFORM_NOT_ALLOWED. لهذا جعلنا في المثال نقطة اتصال لكل مفتاح، ولكل منها متغيّرها. وتُخصم كل المفاتيح من الرصيد نفسه.

تأمين LibreChat المستضاف ذاتيًا#

أنت من يدير الخادم، فأنت من يقرّر من يستخدم رصيدك.

• أغلق التسجيل. يذكر مرجع .env في LibreChat المتغيّر ALLOW_REGISTRATION وقيمته الافتراضية true. أنشئ حساباتك أولًا، ثم اضبط ALLOW_REGISTRATION=false.
• شغّل LibreChat عبر HTTPS فقط، خلف وسيط عكسي بشهادة صالحة، حتى لا تنتقل بيانات الدخول والمحادثات نصًا مكشوفًا.
• احفظ المفاتيح في .env أو في مخزن الأسرار على خادمك فقط. ولا يحمل librechat.yaml إلا مراجع ${...}، لا مفاتيح. وأبقِ .env خارج Git.
• في النسخة المشتركة خصّص لـ LibreChat مفاتيح خاصة به، وضع على كل مفتاح حدًا للإنفاق وتاريخ انتهاء وقائمة عناوين IP مسموح بها (التحكم في المفاتيح). فإن تسرّب مفتاح لن ينفق أكثر مما سمحت به.

التحكم في تكلفة LibreChat#

يُدفع كل طلب من رصيدك حسب التوكنات التي يستخدمها، بسعر النموذج في خبير (الأسعار والرصيد). والمحادثة الطويلة ترسل رسائلها السابقة مع كل رد، فتزيد تكلفة الرسالة كلما طالت. وعناوين المحادثات تضيف طلبًا صغيرًا لكل محادثة جديدة، ويمكنك إيقافها بالقيمة titleConvo: false. كما أن المفاتيح المنفصلة لكل نقطة اتصال تفصل استخدام كل مزوّد في لوحة التحكم.

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

• نقطة الاتصال لا تظهر: أحد الحقول name أو apiKey أو baseURL أو models ناقص، أو الملف librechat.yaml غير مربوط. راجع ملف override ثم أعد التشغيل.
• INVALID_API_KEY أو الخطأ 401: المفتاح خطأ أو أُلغي أو لم يُحمَّل. تأكد أن اسم المتغيّر في .env يطابق المرجع ${...}، ثم أعد التشغيل.
• MODEL_PLATFORM_NOT_ALLOWED: النموذج يتبع مزوّدًا غير مزوّد المفتاح. انقله إلى نقطة الاتصال المطابقة.
• عنوان أساسي خطأ: نقاط الاتصال المخصّصة تستخدم https://api.5abeer.ai/v1، أما ANTHROPIC_REVERSE_PROXY فيستخدم https://api.5abeer.ai بلا /v1.
• النموذج غير موجود: في المعرّف خطأ كتابي. انسخه من قائمة النماذج.
• INSUFFICIENT_BALANCE: رصيدك لا يكفي للطلب. اشحن الرصيد ثم أعد المحاولة.

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

أسئلة شائعة#

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

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

هل نقطة الاتصال المخصّصة في LibreChat متوافقة مع OpenAI؟#

نعم. تتحدث نقطة الاتصال المخصّصة بصيغة OpenAI، وخبير يقدّمها على العنوان https://api.5abeer.ai/v1 لنماذج Claude وGPT وGemini.

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

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

هل أفعّل models.fetch؟#

يمكنك ذلك، لكن الأفضل أن تُبقي fetch: false وتكتب المعرّفات بنفسك. وإذا فعّلت الجلب فطابق كل معرّف مع قائمة نماذج خبير.

هل يستطيع كل مستخدم أن يضع مفتاحه الخاص من خبير؟#

نعم. يقبل LibreChat القيمة apiKey: 'user_provided'، فيُدخل كل مستخدم مفتاحه داخل التطبيق ويدفع من رصيده.

هل تعمل نقطة Anthropic المدمجة بمفتاح خبير؟#

نعم، بمفتاح Claude. اضبط ANTHROPIC_REVERSE_PROXY على https://api.5abeer.ai، وضع المفتاح في ANTHROPIC_API_KEY.

المصادر#

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

• وثائق LibreChat: Custom endpoints quick start وCustom endpoint object structure و.env configuration
• وثائق خبير: مفاتيح API والعناوين الأساسية والأخطاء وحلولها