Node.js

يتطلّب OpenClaw Node 22 أو أحدث. سيقوم نص التثبيت باكتشاف Node وتثبيته تلقائيًا — هذه الصفحة مخصّصة للحالات التي تريد فيها إعداد Node يدويًا والتأكد من أن كل شيء مُهيّأ بشكل صحيح (الإصدارات، PATH، التثبيتات العامة).

التحقق من الإصدار

node -v

إذا طبع هذا v22.x.x أو أحدث، فأنت جاهز. إذا لم يكن Node مُثبّتًا أو كان الإصدار قديمًا جدًا، فاختر طريقة تثبيت أدناه.

تثبيت Node

macOS
Linux
Windows

Homebrew (موصى به):

````
```bash
brew install node
```

أو قم بتنزيل مُثبّت macOS من [nodejs.org](https://nodejs.org/).
````

Ubuntu / Debian:

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

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

أو استخدم مدير إصدارات (انظر أدناه).
````

winget (موصى به):

````
```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

أو قم بتنزيل مُثبّت Windows من [nodejs.org](https://nodejs.org/).
````

Using a version manager (nvm, fnm, mise, asdf)

تتيح لك مدراء الإصدارات التبديل بين إصدارات Node بسهولة. من الخيارات الشائعة:

fnm — سريع ومتعدد المنصات
nvm — واسع الاستخدام على macOS/Linux
mise — متعدد اللغات (Node وPython وRuby وغيرها)

مثال باستخدام fnm:

fnm install 22
fnm use 22

تأكد من تهيئة مدير الإصدارات في ملف بدء تشغيل الصدفة لديك (~/.zshrc أو ~/.bashrc). إذا لم يكن كذلك، فقد لا يتم العثور على openclaw في جلسات الطرفية الجديدة لأن PATH لن يتضمن دليل bin الخاص بـ Node.

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

`openclaw: command not found`

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

Find your global npm prefix

npm prefix -g

Check if it's on your PATH

echo "$PATH"

```
ابحث عن `<npm-prefix>/bin` (macOS/Linux) أو `<npm-prefix>` (Windows) في المخرجات.
```

Add it to your shell startup file

macOS / Linux
Windows

أضِف إلى ~/.zshrc أو ~/.bashrc:

export PATH="$(npm prefix -g)/bin:$PATH"

ثم افتح طرفية جديدة (أو شغّل rehash في zsh / hash -r في bash).

أضِف مخرجات npm prefix -g إلى PATH الخاص بالنظام عبر الإعدادات → النظام → متغيرات البيئة.

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

المساعدة

المجتمع

البيئة وتصحيح الأخطاء

بيئة تشغيل Node

الجوانب الداخلية للضغط

إعداد بيئة المطور

بيانات التوثيق

Node.js

Node.js

التحقق من الإصدار

تثبيت Node

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

`openclaw: command not found`

أخطاء الأذونات على `npm install -g` (Linux)

المساعدة

المجتمع

البيئة وتصحيح الأخطاء

بيئة تشغيل Node

الجوانب الداخلية للضغط

إعداد بيئة المطور

بيانات التوثيق

​Node.js

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

​تثبيت Node

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

​openclaw: command not found

​أخطاء الأذونات على npm install -g (Linux)

Node.js

التحقق من الإصدار

تثبيت Node

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

`openclaw: command not found`

أخطاء الأذونات على `npm install -g` (Linux)