التثبيت

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

• 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@latest
openclaw onboard --install-daemon

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# من المصدر

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

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

# التثبيت من GitHub main

npm install -g github:openclaw/openclaw#main

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

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

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw 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"