Node.js¶

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

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

node -v

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

تثبيت Node¶

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/).
````

تتيح لك مدراء الإصدارات التبديل بين إصدارات 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.

bash npm prefix -g bash echo "$PATH"

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

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

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

        ثم افتح طرفية جديدة (أو شغّل `rehash` في zsh / `hash -r` في bash).
      </Tab>
      <Tab title="Windows">
        أضِف مخرجات `npm prefix -g` إلى PATH الخاص بالنظام عبر الإعدادات → النظام → متغيرات البيئة.
      </Tab>
    </Tabs>
    ```

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