التثبيت

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

• Node 24 (موصى به) أو Node 22.16+ - يتولى نص التثبيت البرمجي ذلك تلقائيا
• macOS أو Linux أو Windows - يدعم كل من Windows الأصلي و WSL2؛ و 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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

من المصدر

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

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

أو تجاوز الربط واستخدم pnpm openclaw ... من داخل المستودع. راجع الإعداد لتدفقات عمل التطوير الكاملة.

التثبيت من GitHub main

npm install -g github:openclaw/openclaw#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 أولا، مع عنصر تسجيل دخول في مجلد Startup لكل مستخدم كخيار احتياطي إذا رفض إنشاء المهمة

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

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

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

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