الانتقال إلى المحتوى الرئيسي

​
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

Homebrew (موصى به):
brew install node
أو نزّل مثبّت macOS من 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

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

اعثر على npm prefix العام لديك

npm prefix -g
2

تحقق مما إذا كان موجودًا على PATH

echo "$PATH"
ابحث عن <npm-prefix>/bin ‏(macOS/Linux) أو <npm-prefix> ‏(Windows) في الخرج.
3

أضِفه إلى ملف بدء تشغيل shell لديك

أضف إلى ~/.zshrc أو ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
ثم افتح طرفية جديدة (أو شغّل rehash في zsh / hash -r في bash).

​
أخطاء الأذونات في 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 لجعله دائمًا.

​
ذو صلة