تثبيت

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

• Node 22.19+ أو 23.11+ أو 24+ - الإصدار 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 الأصلي: ‏Scheduled Task أولًا، مع الرجوع إلى عنصر تسجيل دخول لكل مستخدم في مجلد 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؟