التثبيت
هل اتبعت بالفعل الشروع في العمل؟ أنت جاهز — هذه الصفحة مخصصة لطرق التثبيت البديلة، والتعليمات الخاصة بمنصة معينة، والصيانة.
متطلبات النظام
- Node 22+ (سيقوم سكريبت المثبت بتثبيته إذا كان مفقودًا)
- نظام macOS، أو Linux، أو Windows
pnpmفقط إذا كنت تريد البناء من المصدر
ℹ️ على نظام Windows، نوصي بشدة بتشغيل OpenClaw تحت WSL2.
طرق التثبيت
💡 سكريبت المثبت هو الطريقة الموصى بها لتثبيت OpenClaw. فهو يتعامل مع اكتشاف Node، والتثبيت، والتهيئة في خطوة واحدة.
⚠️ لمضيفات VPS/السحابية، تجنب صور السوق "بنقرة واحدة" من طرف ثالث عند الإمكان. يُفضل استخدام صورة نظام تشغيل أساسية نظيفة (مثل Ubuntu LTS)، ثم قم بتثبيت OpenClaw بنفسك باستخدام سكريبت المثبت.
طرق تثبيت أخرى
Docker
نشرات معزولة بالحاويات أو بدون واجهة.
Podman
حاوية بدون صلاحيات الجذر: قم بتشغيل setup-podman.sh مرة واحدة، ثم سكريبت الإطلاق.
Nix
تثبيت تصريحي عبر Nix.
Ansible
توفير آلي للأساطيل.
Bun
استخدام واجهة سطر الأوامر فقط عبر بيئة تشغيل Bun.
بعد التثبيت
تحقق من أن كل شيء يعمل:
openclaw doctor # التحقق من مشاكل التكوين
openclaw status # حالة البوابة
openclaw dashboard # فتح واجهة المستخدم في المتصفح
إذا كنت بحاجة إلى مسارات وقت تشغيل مخصصة، استخدم:
OPENCLAW_HOMEللمسارات الداخلية القائمة على الدليل الرئيسيOPENCLAW_STATE_DIRلموقع الحالة القابلة للتعديلOPENCLAW_CONFIG_PATHلموقع ملف التكوين
راجع متغيرات البيئة للحصول على تفاصيل كاملة وأولويات.