English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

يتطلب 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

macOS

Homebrew (موصى به):

brew install node

أو نزّل مثبت macOS من nodejs.org.

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

sudo dnf install nodejs

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

Windows

winget (موصى به):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

أو نزّل مثبت Windows من nodejs.org.

Using a version manager (nvm, fnm, mise, asdf)

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

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

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

fnm install 24
fnm use 24

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

openclaw: command not found

يعني هذا دائمًا تقريبًا أن دليل bin العام الخاص بـ npm غير موجود في PATH لديك.

  • Find your global npm prefix

    npm prefix -g

  • Check if it's on your PATH

    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

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

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

    ثم افتح طرفية جديدة (أو شغّل rehash في zsh / hash -r في bash).

    Windows

    أضف ناتج npm prefix -g إلى PATH الخاص بالنظام عبر Settings → System → Environment Variables.

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

    إذا رأيت أخطاء EACCES، فبدّل البادئة العامة لـ npm إلى دليل قابل للكتابة من قبل المستخدم:

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

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

    ذات صلة