docs/docs/ar/install/node.md

read_when	summary	title	x-i18n
تحتاج إلى تثبيت Node.js قبل تثبيت OpenClaw لقد ثبّت OpenClaw لكن `openclaw` يظهر على أنه command not found يفشل `npm install -g` بسبب مشكلات الأذونات أو PATH	تثبيت Node.js وتهيئته لـ OpenClaw — متطلبات الإصدار، وخيارات التثبيت، واستكشاف أخطاء PATH وإصلاحها	Node.js	generated_at model provider source_hash source_path workflow 2026-04-24T07:49:12Z gpt-5.4 openai 99c72b917fa8beba136ee6010799c0183cff8b2420b5a1bd256d9155e50f065a install/node.md 15

يتطلب OpenClaw Node 22.14 أو أحدث. ويُعد Node 24 هو وقت التشغيل الافتراضي والمُوصى به للتثبيتات، وCI، وتدفقات الإصدار. ولا يزال Node 22 مدعومًا عبر خط LTS النشط. وسيكتشف سكربت التثبيت Node ويثبّته تلقائيًا — وهذه الصفحة مخصصة للحالات التي تريد فيها إعداد Node بنفسك والتأكد من أن كل شيء موصول بشكل صحيح (الإصدارات، وPATH، والتثبيتات العامة).

تحقق من إصدارك

node -v

إذا طبع هذا v24.x.x أو أحدث، فأنت تستخدم الإعداد الافتراضي الموصى به. وإذا طبع v22.14.x أو أحدث، فأنت تستخدم مسار Node 22 LTS المدعوم، لكننا لا نزال نوصي بالترقية إلى Node 24 عندما يكون ذلك مناسبًا. وإذا لم يكن Node مثبتًا أو كان الإصدار قديمًا جدًا، فاختر إحدى طرق التثبيت أدناه.

تثبيت Node

**Homebrew** ‏(موصى به):

```bash
brew install node
```

أو نزّل مثبت macOS من [nodejs.org](https://nodejs.org/).

**Ubuntu / Debian:**

```bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
```

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

أو استخدم مدير إصدارات (راجع أدناه).

**winget** ‏(موصى به):

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

أو نزّل مثبت Windows من [nodejs.org](https://nodejs.org/).

تتيح لك أدوات إدارة الإصدارات التبديل بين إصدارات Node بسهولة. ومن الخيارات الشائعة:

• fnm — سريع ومتعدد المنصات
• nvm — واسع الاستخدام على macOS/Linux
• mise — متعدد اللغات (Node، وPython، وRuby، وغير ذلك)

مثال باستخدام fnm:

fnm install 24
fnm use 24

تأكد من تهيئة مدير الإصدارات في ملف بدء تشغيل shell الخاص بك (`~/.zshrc` أو `~/.bashrc`). وإذا لم تفعل ذلك، فقد لا يتم العثور على `openclaw` في جلسات الطرفية الجديدة لأن PATH لن يتضمن دليل bin الخاص بـ Node.

استكشاف الأخطاء وإصلاحها

openclaw: command not found

هذا يعني في الغالب أن دليل npm العام الخاص بـ bin غير موجود على PATH.

```bash npm prefix -g ``` ```bash echo "$PATH" ```

ابحث عن `<npm-prefix>/bin` ‏(macOS/Linux) أو `<npm-prefix>` ‏(Windows) في المخرجات.

أضف إلى `~/.zshrc` أو `~/.bashrc`:

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

    ثم افتح طرفية جديدة (أو شغّل `rehash` في zsh أو `hash -r` في bash).
  </Tab>
  <Tab title="Windows">
    أضف مخرجات `npm prefix -g` إلى PATH النظام عبر Settings → System → Environment Variables.
  </Tab>
</Tabs>

أخطاء الأذونات عند npm install -g ‏(Linux)

إذا رأيت أخطاء EACCES، فحوّل npm global prefix إلى دليل يمكن للمستخدم الكتابة فيه:

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

أضف سطر export PATH=... إلى ~/.bashrc أو ~/.zshrc لجعله دائمًا.

ذو صلة

• نظرة عامة على التثبيت — جميع طرق التثبيت
• التحديث — إبقاء OpenClaw محدثًا
• البدء — الخطوات الأولى بعد التثبيت