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
• شروع به کار - نخستین گام‌ها پس از نصب