Node.js

يتطلب OpenClaw إصدار Node 22.22.3+، أو Node 24.15+، أو Node 25.9+. يُعد Node 24 بيئة التشغيل الافتراضية والموصى بها لعمليات التثبيت وCI وسير عمل الإصدارات؛ ويظل Node 22 مدعومًا عبر خط LTS النشط. Node 23 غير مدعوم. يكتشف برنامج التثبيت النصي Node ويثبّته تلقائيًا — استخدم هذه الصفحة عندما تريد إعداد Node بنفسك (الإصدارات، وPATH، وعمليات التثبيت العامة).

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

node -v

يُعد v24.15.0 أو إصدار 24.x أحدث الخيار الافتراضي الموصى به. ويُعد v22.22.3 أو إصدار 22.x أحدث مسار Node 22 LTS المدعوم؛ كما أن Node v25.9.0+ مدعوم أيضًا. Node 23 غير مدعوم. إذا كان Node غير مثبت أو خارج النطاق المدعوم، فاختر إحدى طرق التثبيت أدناه.

تثبيت Node

macOS
Linux
Windows

Homebrew (موصى به):

brew install node

أو نزّل برنامج تثبيت macOS من nodejs.org.

Ubuntu / Debian:

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

Fedora / RHEL:

sudo dnf install nodejs

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

winget (موصى به):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

أو نزّل برنامج تثبيت Windows من nodejs.org.

استخدام مدير إصدارات (nvm، وfnm، وmise، وasdf)

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

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

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

fnm install 24
fnm use 24

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

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

`openclaw: command not found`

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

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

npm prefix -g

التحقق من وجودها في PATH

echo "$PATH"

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

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

macOS / Linux
Windows

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

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

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

أضف مخرجات npm prefix -g إلى PATH للنظام عبر Settings → System → Environment Variables.

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

Install overview

Maintenance

Containers

Hosting

Advanced setup

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

تثبيت Node

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

`openclaw: command not found`

أخطاء الأذونات في `npm install -g` ‏(Linux)

مواضيع ذات صلة

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

​تثبيت Node

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

​openclaw: command not found

​أخطاء الأذونات في npm install -g ‏(Linux)

​مواضيع ذات صلة

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

تثبيت Node

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

`openclaw: command not found`

أخطاء الأذونات في `npm install -g` ‏(Linux)

مواضيع ذات صلة