ثبّت

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

• Node 24 (موصى به) أو Node 22.19+ - يتولى سكربت المثبّت ذلك تلقائياً
• 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-checkout ضمن مسار البادئة نفسه. المرجع الكامل: تفاصيل المثبّت الداخلية.

مثبّت مسبقاً؟ بدّل بين تثبيتات الحزمة و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      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

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

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

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

انشر OpenClaw على خادم سحابي أو VPS:

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

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

إذا نجح التثبيت لكن لم يتم العثور على openclaw في الطرفية لديك:

node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?

إذا لم يكن $(npm prefix -g)/bin موجوداً في $PATH لديك، فأضفه إلى ملف بدء تشغيل الصدفة (~/.zshrc أو ~/.bashrc):

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

ثم افتح طرفية جديدة. راجع إعداد Node لمزيد من التفاصيل.