تثبيت OpenClaw
ثبّت واجهة سطر الأوامر openclaw باستخدام السكربت الرسمي أو أداة التثبيت عبر PowerShell أو npm، ثم دع معالج الإعداد ينشئ ملف الإعداد ورمز gateway والخدمة التي تعمل في الخلفية.
يتطلب التثبيت عبر npm الإصدار Node.js 24.16+ أو 26.1+؛ أما سكربتات التثبيت فتُعدّ Node لك. خصّص موارد لا تقل عن 1 vCPU و1 GB من RAM و500 MB من مساحة القرص.
شغّل أداة التثبيت على macOS أو Linux أو WSL2
يثبّت السكربت Node عند الحاجة (Node 26 على macOS، وNode 24 LTS على Linux) وواجهة سطر الأوامر openclaw، ثم يبدأ معالج الإعداد. للتثبيت من دون المعالج، استخدم pipe إلى bash -s -- --no-onboard بدلاً من bash وحده.
shell curl -fsSL https://openclaw.ai/install.sh | bashأو استخدم PowerShell على Windows
على Windows الأصلي، شغّل أداة التثبيت عبر PowerShell في نافذة PowerShell. يتوفر أيضاً تطبيق Hub الأصلي لـ Windows، ويمكنك بدلاً من ذلك استخدام سكربت shell الوارد في الخطوة 1 داخل WSL2.
PowerShell iwr -useb https://openclaw.ai/install.ps1 | iexأو ثبّت باستخدام npm
إذا كنت تدير Node بنفسك، فثبّت الحزمة على مستوى النظام. يتطلب npm 12 و11.16+ استخدام --allow-scripts=openclaw؛ ولا تضف هذا الخيار مع npm 11.15 أو أقدم. يشغّل onboard --install-daemon المعالج ثم يثبّت الخدمة: LaunchAgent على macOS، وخدمة systemd للمستخدم على Linux وWSL2، ومهمة مجدولة على Windows.
shell npm install -g openclaw@latest --allow-scripts=openclaw openclaw onboard --install-daemonتحقّق من التثبيت
يعرض openclaw --version الإصدار المثبّت، ويجري openclaw doctor فحوصات السلامة، ويبيّن openclaw gateway status ما إذا كانت خدمة gateway قيد التشغيل. ترقيم الإصدارات قائم على التاريخ، بصيغة YYYY.M.N.
shell openclaw --version openclaw doctor openclaw gateway statusحافظ على تحديث البرنامج
يثبّت openclaw update أحدث إصدار. استخدم --channel للتبديل بين stable وextended-stable وbeta وdev، واستخدم --dry-run لمعاينة التحديث من دون تطبيقه. يتوفر أيضاً الأمران openclaw update status وopenclaw update repair.
shell openclaw update openclaw update --channel beta openclaw update --dry-run
ينشئ معالج الإعداد رمز gateway ويُبقي gateway على 127.0.0.1:18789. راجع دليل تعزيز الأمان قبل ربط قناة محادثة.