شرح OpenClaw بالعربي: الإعداد مع مفتاح خبير

لتشغّل OpenClaw على خبير، ثبّت OpenClaw، وأضف مزوّدًا باسم khabeer ونموذجًا افتراضيًا إلى ملف ~/.openclaw/openclaw.json مع مفتاح API من خبير، ثم تحقق من الملف بالأمر openclaw config validate. بعدها شغّل openclaw chat لتحادث وكيله في الطرفية، ويُدفع كل طلب من رصيدك في خبير. ومع الاشتراك يتولى تطبيق 5abeer AI هذا الإعداد عنك.

ما الذي تحصل عليه#

• OpenClaw كما هو، مع خبير مزوّدًا جاهزًا للنماذج.
• نماذج Claude وGPT وGemini المتاحة في OpenClaw، بأقل من سعرها الرسمي.
• استخدامك وتكلفته في لوحة التحكم، لكل مفتاح.

قبل أن تبدأ#

• طرفية على macOS أو Linux أو Windows.
• Node.js بالإصدار 24.16 أو أحدث من الفرع 24، أو 26.1 أو أحدث، إذا ثبّت OpenClaw بالأمر npm فقط. سكربت التثبيت يجهّز Node بنفسه.
• مفتاح API لمزوّد النموذج الذي ستستخدمه (أنشئ مفتاحًا). الإعداد أدناه يستخدم نموذجًا من Claude، فيحتاج إلى مفتاح لنماذج Claude.

مع اشتراك: تطبيق 5abeer AI#

إذا كان لديك اشتراك في خبير يشمل OpenClaw، فإن تطبيق 5abeer AI يضبطه على اشتراكك بنقرة واحدة، دون مفتاح API ودون أن تفتح أي ملف. يعمل التطبيق على Mac وWindows وLinux، والتفاصيل في ما الذي تشغّله كل باقة. أما بمفتاح API فاتبع الإعداد اليدوي أدناه.

الإعداد اليدوي#

1. 1

   ثبّت OpenClaw#

   هذه الأوامر تتخطى معالج الإعداد في OpenClaw، لأن الخطوة التالية تضبط المزوّد عنك.

   macOS / LinuxWindowsnpm

   انسخ

   curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

   إذا كان إصدار npm لديك 11.15 أو أقدم، فشغّل أمر npm دون --allow-scripts=openclaw.

2. 2

   أضف الإعداد#

   أضف المقطعين models وagents إلى ملف ~/.openclaw/openclaw.json، دون حذف إعداداتك الأخرى إن كان الملف موجودًا. المفتاح يوضع داخل الملف نفسه، فاستبدل YOUR_5ABEER_API_KEY بمفتاحك.

   openclaw.jsonانسخ

   {
     "models": {
       "providers": {
         "khabeer": {
           "baseUrl": "https://api.5abeer.ai/v1",
           "apiKey": "YOUR_5ABEER_API_KEY",
           "api": "openai-completions",
           "models": [
             {
               "id": "claude-sonnet-5.5",
               "name": "Claude Sonnet 5.5"
             }
           ]
         }
       }
     },
     "agents": {
       "defaults": {
         "model": {
           "primary": "khabeer/claude-sonnet-5.5"
         }
       }
     }
   }
   

   ~/.openclaw/openclaw.json

3. 3

   تحقق من الملف#

   Terminalانسخ

   openclaw config validate

4. 4

   شغّله#

   Terminalانسخ

   openclaw chat

   اكتب أي طلب. إذا وصلك الرد فالإعداد يعمل.

اختر النموذج#

هذه النماذج تعمل في OpenClaw الآن. أضف النموذج إلى القائمة models في ملف الإعداد، واجعل معرّفه بعد khabeer/ في primary. تذكّر أن كل مفتاح يعمل مع نماذج المزوّد الذي أنشأته له فقط.

إذا ظهر خطأ#

• INVALID_API_KEY: المفتاح في الملف غير صحيح أو منسوخ ناقصًا.
• MODEL_PLATFORM_NOT_ALLOWED: النموذج من مزوّد غير مزوّد المفتاح.
• INSUFFICIENT_BALANCE: الرصيد لا يكفي لهذا الطلب.

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

أسئلة شائعة#

لماذا نتخطى معالج الإعداد؟#

يطلب منك المعالج اختيار مزوّد للنماذج وتسجيل الدخول إليه. إعداد خبير في هذا الدليل يغني عن هذه الخطوة، فلا تحتاج إلى حساب لدى مزوّد آخر.

ماذا أفعل إذا أظهر openclaw config validate خطأً؟#

غالبًا يوجد خطأ في كتابة الملف، أو لُصق المقطعان الجديدان داخل مقطع آخر. قارن الملف بالإعداد أعلاه واحفظه، ثم شغّل الأمر من جديد.

أين يُحفظ مفتاحي؟#

في ملف ~/.openclaw/openclaw.json على جهازك، نصًا غير مشفّر. لا تشارك الملف، واستبدل المفتاح فيه إذا أنشأت مفتاحًا جديدًا.

كيف تُحسب تكلفة الطلب؟#

تُدفع تكلفة كل طلب من رصيدك حسب عدد التوكنات التي يستهلكها، بسعر النموذج في خبير. التفاصيل في الأسعار والرصيد.