OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

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

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

bash
node -v

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

تثبيت Node

macOS

Homebrew (موصى به):

bash
brew install node

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

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

bash
sudo dnf install nodejs

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

Windows

winget (موصى به):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

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

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

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

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

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

bash
fnm install 24fnm use 24

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

openclaw: command not found

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

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

    bash
    npm prefix -g

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

    bash
    echo "$PATH"

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

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

    macOS / Linux

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

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

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

    Windows

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

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

    إذا ظهرت أخطاء EACCES، فغيّر البادئة العامة لـ npm إلى دليل يمكن للمستخدم الكتابة فيه:

    bash
    mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

    أضف السطر export PATH=... إلى ~/.bashrc أو ~/.zshrc لجعل التغيير دائمًا.

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

    Was this useful?
    On this page

    On this page