Skip to main content

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

  • Node 22.22.3+ أو 24.15+ أو 25.9+ - يُعد Node 24 الإصدار المستهدف الافتراضي؛ ويتولى برنامج التثبيت النصي ذلك تلقائيًا.
  • macOS أو Linux أو Windows - يمكن لمستخدمي Windows البدء بتطبيق Windows Hub الأصلي، أو مثبّت CLI عبر PowerShell، أو Gateway على WSL2. راجع Windows.
  • لا يلزم pnpm إلا عند البناء من المصدر.

​
موصى به: برنامج التثبيت النصي

أسرع طريقة للتثبيت. يكتشف نظام التشغيل لديك، ويثبّت Node عند الحاجة، ويثبّت OpenClaw، ثم يبدأ الإعداد الأولي.
يمكن لمستخدمي سطح مكتب Windows أيضًا تثبيت التطبيق المرافق الأصلي Windows Hub، الذي يتضمن الإعداد، وحالة علبة النظام، والدردشة، ووضع Node، ووضع MCP المحلي.
للتثبيت من دون تشغيل الإعداد الأولي:
للاطلاع على جميع العلامات وخيارات CI/الأتمتة، راجع تفاصيل المثبّت الداخلية.

​
طرق تثبيت بديلة

​
مثبّت البادئة المحلية (install-cli.sh)

استخدم هذا الخيار عندما تريد إبقاء OpenClaw وNode ضمن بادئة محلية مثل ~/.openclaw، من دون الاعتماد على تثبيت Node على مستوى النظام:
يدعم تثبيتات npm افتراضيًا، بالإضافة إلى التثبيتات من نسخة git محلية ضمن مسار البادئة نفسه. المرجع الكامل: تفاصيل المثبّت الداخلية. هل ثبّتته بالفعل؟ بدّل بين تثبيتات الحزمة وgit باستخدام openclaw update --channel dev وopenclaw update --channel stable. راجع التحديث.

​
npm أو pnpm أو bun

إذا كنت تدير Node بنفسك بالفعل:
يزيل المثبّت المستضاف مرشحات حداثة npm مثل min-release-age عند تثبيت حزمة OpenClaw. إذا أجريت التثبيت يدويًا باستخدام npm، فستظل سياسة npm الخاصة بك مطبّقة.

​
من المصدر

للمساهمين أو لأي شخص يريد التشغيل من نسخة محلية:
أو تخطَّ الربط واستخدم pnpm openclaw ... من داخل المستودع. راجع الإعداد للاطلاع على مسارات عمل التطوير الكاملة.

​
التثبيت من نسخة الفرع الرئيسي على GitHub

​
الحاويات ومديرو الحزم

Docker

عمليات نشر ضمن حاويات أو من دون واجهة.

Podman

بديل لـ Docker بحاويات لا تتطلب صلاحيات الجذر.

Nix

تثبيت تصريحي عبر Nix flake.

Ansible

تجهيز آلي لمجموعة من الأجهزة.

Bun

مثبّت اختياري للتبعيات ومشغّل لبرامج الحزم النصية.

​
التحقق من التثبيت

إذا أردت بدء تشغيل مُدارًا بعد التثبيت:
  • macOS: ‏LaunchAgent عبر openclaw onboard --install-daemon أو openclaw gateway install
  • Linux/WSL2: خدمة مستخدم systemd عبر الأوامر نفسها
  • Windows الأصلي: مهمة مجدولة أولًا، مع عنصر تسجيل دخول لكل مستخدم في مجلد Startup كخيار احتياطي إذا رُفض إنشاء المهمة

​
الاستضافة والنشر

انشر OpenClaw على خادم سحابي أو VPS. راجع خادم Linux للاطلاع على أداة اختيار المزوّد الكاملة (DigitalOcean وHetzner وHostinger وFly.io وGCP وAzure وRailway وNorthflank وOracle Cloud وRaspberry Pi والمزيد)، أو انشره تصريحيًا على Render.

VPS

اختر مزوّدًا.

جهاز Docker افتراضي

خطوات Docker المشتركة.

Kubernetes

نشر K8s.

​
التحديث أو الترحيل أو إلغاء التثبيت

التحديث

حافظ على تحديث OpenClaw.

الترحيل

انتقل إلى جهاز جديد.

إلغاء التثبيت

أزل OpenClaw بالكامل.

​
استكشاف الأخطاء وإصلاحها: تعذّر العثور على openclaw

غالبًا ما تكون المشكلة في PATH: دليل الملفات التنفيذية العامة لـ npm غير موجود في PATH الخاص بصدفتك. راجع استكشاف أخطاء Node.js وإصلاحها للاطلاع على الحل الكامل، بما في ذلك مسار Windows.