---
title: "تثبيت OpenClaw على macOS وLinux وWindows · DotsAgent"
description: "ثبّت OpenClaw باستخدام السكربت الرسمي أو PowerShell أو npm، وشغّل معالج الإعداد، ثم تحقّق من التثبيت باستخدام openclaw doctor وانتقل بين تحديثات stable وbeta وdev."
url: https://dotsagent.io/ar/openclaw/install
---

دليل OpenClaw · 5 خطوات

# تثبيت OpenClaw

ثبّت واجهة سطر الأوامر openclaw باستخدام السكربت الرسمي أو أداة التثبيت عبر PowerShell أو npm، ثم دع معالج الإعداد ينشئ ملف الإعداد ورمز gateway والخدمة التي تعمل في الخلفية.

يتطلب التثبيت عبر npm الإصدار Node.js 24.16+ أو 26.1+؛ أما سكربتات التثبيت فتُعدّ Node لك. خصّص موارد لا تقل عن 1 vCPU و1 GB من RAM و500 MB من مساحة القرص.

1. شغّل أداة التثبيت على 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`
2. أو استخدم PowerShell على Windows على Windows الأصلي، شغّل أداة التثبيت عبر PowerShell في نافذة PowerShell. يتوفر أيضاً تطبيق Hub الأصلي لـ Windows، ويمكنك بدلاً من ذلك استخدام سكربت shell الوارد في الخطوة 1 داخل WSL2. PowerShell`iwr -useb https://openclaw.ai/install.ps1 | iex`
3. أو ثبّت باستخدام 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`
4. تحقّق من التثبيت يعرض openclaw --version الإصدار المثبّت، ويجري openclaw doctor فحوصات السلامة، ويبيّن openclaw gateway status ما إذا كانت خدمة gateway قيد التشغيل. ترقيم الإصدارات قائم على التاريخ، بصيغة YYYY.M.N. shell`openclaw --version openclaw doctor openclaw gateway status`
5. حافظ على تحديث البرنامج يثبّت 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. راجع دليل تعزيز الأمان قبل ربط قناة محادثة.

## المزيد من أدلة OpenClaw

[تشغيل OpenClaw على VPS](https://dotsagent.io/ar/openclaw/vps)

[شغّل OpenClaw في Docker](https://dotsagent.io/ar/openclaw/docker)

[شغّل OpenClaw على Raspberry Pi](https://dotsagent.io/ar/openclaw/raspberry-pi)

[اربط النماذج بـ OpenClaw](https://dotsagent.io/ar/openclaw/models)

[اربط OpenClaw بـ Telegram](https://dotsagent.io/ar/openclaw/telegram)

[عزّز أمان بوابة OpenClaw](https://dotsagent.io/ar/openclaw/hardening)

[الوصول عن بُعد إلى OpenClaw](https://dotsagent.io/ar/openclaw/remote-access)

## المصادر

1. [docs.openclaw.ai](https://docs.openclaw.ai/install)/install
2. [docs.openclaw.ai](https://docs.openclaw.ai/install/updating)/install/updating

مرجع مستقل لمطوّري وكلاء الذكاء الاصطناعي. لا تربطنا أي علاقة بأي من المورّدين المذكورين هنا.

© 2026 DotsAgent · تم التحقق من المعلومات في 1 أكتوبر 2026