تثبيت

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

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

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

أسرع طريقة للتثبيت. يكتشف نظام التشغيل لديك، ويثبّت Node عند الحاجة، ويثبّت OpenClaw، ثم يبدأ الإعداد الأولي.

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

iwr -useb https://openclaw.ai/install.ps1 | iex

للتثبيت من دون تشغيل الإعداد الأولي:

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

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

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

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

استخدم هذا الخيار عندما تريد إبقاء OpenClaw وNode ضمن بادئة محلية مثل ~/.openclaw، من دون الاعتماد على تثبيت Node على مستوى النظام:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

يدعم تثبيتات npm افتراضيًا، بالإضافة إلى التثبيتات من نسخة git محلية ضمن مسار البادئة نفسه. المرجع الكامل: تفاصيل المثبّت الداخلية.

هل ثبّتته بالفعل؟ بدّل بين تثبيتات الحزمة وgit باستخدام openclaw update --channel dev وopenclaw update --channel stable. راجع التحديث.

npm أو pnpm أو bun

إذا كنت تدير Node بنفسك بالفعل:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

من المصدر

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

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

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

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

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

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

openclaw --version      # تأكد من توفر CLIopenclaw doctor         # تحقق من مشكلات الإعدادopenclaw gateway status # تحقق من تشغيل Gateway

إذا أردت بدء تشغيل مُدارًا بعد التثبيت:

• 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.

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

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

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

node -v           # هل Node مثبت؟npm prefix -g     # أين توجد الحزم العامة؟echo "$PATH"      # هل دليل الملفات التنفيذية العامة موجود في PATH؟