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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

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

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

​
openclaw: command not found

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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

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

Add it to your shell startup file

أضف إلى ~/.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 لديك لجعله دائمًا.

​
ذو صلة