English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Install overview

Node.js

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

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

bash
node -v

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

    On this page