English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

Edit source

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

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

bash
node -v

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

Using a version manager (nvm, fnm, mise, asdf)

مدیران نسخه به شما امکان می‌دهند به‌سادگی بین نسخه‌های Node جابه‌جا شوید. گزینه‌های محبوب:

  • fnm - سریع، چندسکویی
  • nvm - پرکاربرد در macOS/Linux
  • mise - چندزبانه (Node، Python، Ruby و غیره)

نمونه با fnm:

bash
fnm install 24fnm use 24

عیب‌یابی

openclaw: command not found

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

  • Find your global npm prefix

    bash
    npm prefix -g

  • Check if it's on your PATH

    bash
    echo "$PATH"

    در خروجی به‌دنبال <npm-prefix>/bin (macOS/Linux) یا <npm-prefix> (Windows) بگردید.

  • Add it to your shell startup file

    macOS / Linux

    به ~/.zshrc یا ~/.bashrc اضافه کنید:

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

    سپس یک ترمینال جدید باز کنید (یا در zsh دستور rehash / در bash دستور hash -r را اجرا کنید).

    Windows

    خروجی npm prefix -g را از طریق Settings → System → Environment Variables به PATH سیستم خود اضافه کنید.

    • خطاهای مجوز در npm install -g (Linux)

    اگر خطاهای EACCES می‌بینید، prefix سراسری 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?