الانتقال إلى المحتوى الرئيسي

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

  • Node 24 (موصى به) أو Node 22.19+ - يتولى سكربت المثبّت ذلك تلقائياً
  • macOS أو Linux أو Windows - يمكن لمستخدمي Windows البدء بتطبيق Windows Hub الأصلي، أو مثبّت CLI عبر PowerShell، أو Gateway على WSL2. راجع Windows.
  • لا تحتاج إلى pnpm إلا إذا كنت تبني من المصدر

​
موصى به: سكربت المثبّت

أسرع طريقة للتثبيت. يكتشف نظام التشغيل لديك، ويثبّت Node عند الحاجة، ويثبّت OpenClaw، ويشغّل الإعداد الأولي.
يمكن لمستخدمي سطح مكتب Windows أيضاً تثبيت تطبيق Windows Hub المرافق الأصلي، والذي يتضمن الإعداد، وحالة صينية النظام، والدردشة، ووضع العقدة، ووضع MCP المحلي.
curl -fsSL https://openclaw.ai/install.sh | bash
للتثبيت من دون تشغيل الإعداد الأولي: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
للاطلاع على جميع العلامات وخيارات 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@latest
openclaw onboard --install-daemon
يمسح المثبّت المستضاف مرشحات حداثة npm مثل min-release-age لتثبيت حزمة OpenClaw. إذا ثبّت يدوياً باستخدام npm، فستظل سياسة npm الخاصة بك مطبقة.

​
من المصدر

للمساهمين أو أي شخص يريد التشغيل من نسخة محلية: 
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 الرئيسية

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

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

Docker

عمليات نشر داخل حاويات أو بلا واجهة.

Podman

بديل حاويات بلا صلاحيات جذرية لـ Docker.

Nix

تثبيت تصريحي عبر Nix flake.

Ansible

تهيئة آلية لأساطيل الأجهزة.

Bun

استخدام CLI فقط عبر وقت تشغيل Bun.

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

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 أولاً، مع عنصر تسجيل دخول احتياطي في مجلد بدء التشغيل لكل مستخدم إذا رُفض إنشاء المهمة

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

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

VPS

أي Linux VPS.

Docker VM

خطوات Docker المشتركة.

Kubernetes

نشر K8s.

Fly.io

النشر على Fly.io.

Hetzner

نشر Hetzner.

GCP

نشر Google Cloud.

Azure

نشر Azure.

Railway

نشر Railway.

Render

نشر Render.

Northflank

نشر Northflank.

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

Updating

أبقِ OpenClaw محدّثاً.

Migrating

الانتقال إلى جهاز جديد.

Uninstall

إزالة OpenClaw بالكامل.

​
استكشاف الأخطاء وإصلاحها: لم يتم العثور على 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 لمزيد من التفاصيل.