Node.js 🟢

دليل إعداد بيئة Node.js المطلوبة لـ OpenClaw.

📋 المتطلبات

  • الإصدار: Node.js ≥ 22
  • مدير الحزم: pnpm (مُوصى به) أو npm
  • اختياري: nvm لإدارة الإصدارات

التثبيت

الطريقة 1: الموقع الرسمي

قم بتنزيل المثبّت من nodejs.org

macOS

# باستخدام Homebrew
brew install node@22

# التحقق من التثبيت
node --version
npm --version

Linux

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora/RHEL
sudo dnf module install nodejs:22

# التحقق
node --version

Windows

  • قم بتنزيل المثبّت من nodejs.org
  • قم بتشغيل .msi file
  • اتبع معالج الإعداد

الطريقة 2: nvm (مُوصى به للمطورين)

Node Version Manager يسمح بالتبديل السهل بين إصدارات Node.

# تثبيت nvm (macOS/Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# تحميل nvm
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# تثبيت Node.js 22
nvm install 22
nvm use 22
nvm alias default 22

# التحقق
node --version

💡 نصيحة: nvm على Windows

استخدم nvm-windows على Windows.

مدير الحزم

pnpm (مُوصى به)

pnpm أسرع وأكثر كفاءة في الذاكرة من npm.

# تثبيت pnpm عالمياً
npm install -g pnpm

# التحقق
pnpm --version

# استخدام pnpm في مشروع
cd openclaw
pnpm install
pnpm build
pnpm gateway:watch

npm (بديل)

يأتي npm مع Node.js بشكل افتراضي.

# npm يأتي مع Node.js
npm --version

# استخدام npm
cd openclaw
npm install
npm run build

التحقق من الإعداد

# التحقق من إصدارات Node
node --version  # يجب أن يكون >= v22.0.0
npm --version

# اختبار Node.js
node -e "console.log('Node.js يعمل!')"

# التحقق من التثبيت العالمي
npm list -g --depth=0

مشاكل شائعة

مشاكل الصلاحيات (Linux/macOS)

إذا واجهت أخطاء EACCES مع npm global:

# الحل 1: استخدم nvm (مُوصى به)
# nvm يدير الأذونات تلقائياً

# الحل 2: غيّر مجلد npm العالمي
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

إصدار Node.js القديم

# إذا كان Node < v22، قم بالترقية
# باستخدام nvm:
nvm install 22
nvm use 22

# أو قم بإعادة التثبيت من nodejs.org

الوحدات الأصلية لا تُبنى

قد تتطلب بعض الحزم أدوات البناء:

macOS

xcode-select --install

Ubuntu/Debian

sudo apt-get install build-essential

Windows

# قم بتشغيل PowerShell كمسؤول
npm install --global windows-build-tools

أفضل الممارسات

  • استخدم nvm: للتبديل السهل بين المشاريع
  • pnpm للمونوريبوس: أسرع وأكثر كفاءة في المساحة
  • أبق Node محدثاً: استخدم دائماً LTS أو أحدث
  • استخدم .nvmrc: يحدد إصدار Node للمشروع
# إنشاء .nvmrc في جذر المشروع
echo "22" > .nvmrc

# استخدام الإصدار المحدد تلقائياً
nvm use

الخطوات التالية

بمجرد إعداد Node.js، يمكنك:

  1. تثبيت OpenClaw: npm install -g openclaw
  2. بدء Gateway: openclaw gateway
  3. تكوين Agent: openclaw setup

موارد ذات صلة