Node.js

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

بررسی نسخه

node -v

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