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

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

node -v
إذا طبع هذا الأمر v24.x.x أو أعلى، فأنت تستخدم الافتراضي الموصى به. إذا طبع v22.19.x أو أعلى، فأنت على مسار Node 22 LTS المدعوم، لكننا لا نزال نوصي بالترقية إلى Node 24 عندما يكون ذلك مناسبًا. إصدارات Node 23 الأقدم من v23.11.0 غير مدعومة. إذا لم يكن 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
تأكد من تهيئة مدير الإصدارات في ملف بدء تشغيل الصدفة لديك (~/.zshrc أو ~/.bashrc). إذا لم يكن كذلك، فقد لا يتم العثور على openclaw في جلسات الطرفية الجديدة لأن PATH لن يتضمن دليل bin الخاص بـ Node.

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

​
openclaw: command not found

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

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

npm prefix -g
2

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

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

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

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

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

​
ذات صلة