Node.js

OpenClaw به Node 22.14 یا جدیدتر نیاز دارد. Node 24 runtime پیش‌فرض و پیشنهادی برای نصب‌ها، CI و گردش‌کارهای انتشار است. Node 22 همچنان از طریق خط فعال LTS پشتیبانی می‌شود. اسکریپت نصب به‌صورت خودکار Node را تشخیص می‌دهد و نصب می‌کند - این صفحه برای زمانی است که می‌خواهید Node را خودتان راه‌اندازی کنید و مطمئن شوید همه‌چیز درست متصل شده است (نسخه‌ها، PATH، نصب‌های سراسری).

# نسخه خود را بررسی کنید

node -v

اگر این دستور v24.x.x یا بالاتر را چاپ کند، روی پیش‌فرض پیشنهادی هستید. اگر v22.14.x یا بالاتر را چاپ کند، روی مسیر پشتیبانی‌شده Node 22 LTS هستید، اما همچنان پیشنهاد می‌کنیم هر زمان مناسب بود به Node 24 ارتقا دهید. اگر 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 24
fnm 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
• شروع به کار - نخستین گام‌ها پس از نصب