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

brew install node

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

sudo dnf install nodejs

winget install OpenJS.NodeJS.LTS

choco install nodejs-lts

fnm install 24fnm use 24

عیب‌یابی

openclaw: command not found

این خطا تقریباً همیشه به این معنی است که پوشه bin سراسری npm در PATH شما قرار ندارد.

npm prefix -g

echo "$PATH"

export PATH="$(npm prefix -g)/bin:$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 خود اضافه کنید.

مطالب مرتبط

• نمای کلی نصب - همه روش‌های نصب
• به‌روزرسانی - به‌روز نگه‌داشتن OpenClaw
• شروع به کار - نخستین گام‌ها پس از نصب