OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk 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

يعني هذا في الغالب أن دليل الملفات التنفيذية العامة الخاص بـ 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