English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Install overview

Node.js

يتطلب OpenClaw Node 22.19+، أو Node 23.11+، أو Node 24+. Node 24 هو وقت التشغيل الافتراضي والموصى به للتثبيتات وCI وسير عمل الإصدارات. يظل Node 22 مدعومًا عبر خط LTS النشط. سيكتشف برنامج التثبيت النصي Node ويثبته تلقائيًا - هذه الصفحة مخصصة عندما تريد إعداد Node بنفسك والتأكد من أن كل شيء موصول بشكل صحيح (الإصدارات، وPATH، والتثبيتات العامة).

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

bash
node -v

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

تثبيت Node

macOS

Homebrew (موصى به):

bash
brew install node

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

Linux

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

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

Windows

winget (موصى به):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

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

استخدام مدير إصدارات (nvm، fnm، mise، asdf)

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

  • fnm - سريع ويعمل عبر الأنظمة
  • nvm - مستخدم على نطاق واسع على macOS/Linux
  • mise - متعدد اللغات (Node، وPython، وRuby، وغيرها)

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

bash
fnm install 24fnm use 24

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

openclaw: command not found

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

  • اعثر على بادئة npm العامة لديك

    bash
    npm prefix -g

  • تحقق مما إذا كانت موجودة في PATH لديك

    bash
    echo "$PATH"

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

  • أضفها إلى ملف بدء تشغيل الصدفة لديك

    macOS / Linux

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

    bash
    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 العامة إلى دليل يمكن للمستخدم الكتابة فيه:

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

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

    ذات صلة

    Was this useful?
    On this page

    On this page