الانتقال إلى المحتوى الرئيسي

نظرة عامة على التثبيت

التثبيت

هل اتبعت بالفعل الشروع في العمل؟ أنت جاهز — هذه الصفحة مخصصة لطرق التثبيت البديلة، والتعليمات الخاصة بمنصة معينة، والصيانة.

متطلبات النظام​

  • Node 22+ (سيقوم سكريبت المثبت بتثبيته إذا كان مفقودًا)
  • نظام macOS، أو Linux، أو Windows
  • pnpm فقط إذا كنت تريد البناء من المصدر

ℹ️ على نظام Windows، نوصي بشدة بتشغيل OpenClaw تحت WSL2.

طرق التثبيت​

💡 سكريبت المثبت هو الطريقة الموصى بها لتثبيت OpenClaw. فهو يتعامل مع اكتشاف Node، والتثبيت، والتهيئة في خطوة واحدة.

⚠️ لمضيفات VPS/السحابية، تجنب صور السوق "بنقرة واحدة" من طرف ثالث عند الإمكان. يُفضل استخدام صورة نظام تشغيل أساسية نظيفة (مثل Ubuntu LTS)، ثم قم بتثبيت OpenClaw بنفسك باستخدام سكريبت المثبت.

يقوم بتنزيل واجهة سطر الأوامر، وتثبيتها عالميًا عبر npm، وإطلاق معالج التهيئة.

هذا كل شيء — يتعامل السكريبت مع اكتشاف Node، والتثبيت، والتهيئة.لتخطي التهيئة وتثبيت الملف الثنائي فقط:

لجميع الأعلام، متغيرات البيئة، وخيارات CI/الأتمتة، راجع تفاصيل المثبت الداخلية.

إذا كان لديك بالفعل Node 22+ وتفضل إدارة التثبيت بنفسك:

للمساهمين أو أي شخص يريد التشغيل من نسخة محلية.

1

[

](#)

استنساخ وبناء

استنسخ مستودع OpenClaw وقم بالبناء:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

2

[

](#)

ربط واجهة سطر الأوامر

اجعل أمر openclaw متاحًا عالميًا:

pnpm link --global

بدلاً من ذلك، يمكنك تخطي الربط وتشغيل الأوامر عبر pnpm openclaw ... من داخل المستودع.

3

[

](#)

تشغيل التهيئة

openclaw onboard --install-daemon

لعمليات تطوير أعمق، راجع الإعداد.

طرق تثبيت أخرى​

بعد التثبيت​

تحقق من أن كل شيء يعمل:

openclaw doctor         # التحقق من مشاكل التكوين
openclaw status         # حالة البوابة
openclaw dashboard      # فتح واجهة المستخدم في المتصفح

إذا كنت بحاجة إلى مسارات وقت تشغيل مخصصة، استخدم:

  • OPENCLAW_HOME للمسارات الداخلية القائمة على الدليل الرئيسي
  • OPENCLAW_STATE_DIR لموقع الحالة القابلة للتعديل
  • OPENCLAW_CONFIG_PATH لموقع ملف التكوين

راجع متغيرات البيئة للحصول على تفاصيل كاملة وأولويات.

استكشاف الأخطاء وإصلاحها: openclaw غير موجود​

تشخيص سريع:

node -v
npm -v
npm prefix -g
echo "$PATH"

إذا لم يكن $(npm prefix -g)/bin (macOS/Linux) أو $(npm prefix -g) (Windows) موجودًا في $PATH الخاص بك، فإن طرفيتك لا تستطيع العثور على الملفات الثنائية العالمية لـ npm (بما في ذلك openclaw).الإصلاح — أضفه إلى ملف بدء تشغيل الطرفية الخاص بك (~/.zshrc أو ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

على Windows، أضف ناتج أمر npm prefix -g إلى PATH الخاص بك.ثم افتح طرفية جديدة (أو نفذ rehash في zsh / hash -r في bash).

التحديث / إلغاء التثبيت​

تفاصيل المثبت الداخلية