docs/docs/fa/install/node.md

read_when	summary	title	x-i18n
پیش از نصب OpenClaw باید Node.js را نصب کنید OpenClaw را نصب کرده‌اید اما دستور `openclaw` یافت نمی‌شود npm install -g به‌دلیل مشکلات مجوزها یا PATH ناموفق می‌شود	نصب و پیکربندی Node.js برای OpenClaw — الزامات نسخه، گزینه‌های نصب، و عیب‌یابی PATH	Node.js	generated_at model provider source_hash source_path workflow 2026-04-29T23:06:46Z gpt-5.5 openai 99c72b917fa8beba136ee6010799c0183cff8b2420b5a1bd256d9155e50f065a install/node.md 16

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

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

node -v

اگر این دستور v24.x.x یا بالاتر را چاپ کند، روی پیش‌فرض توصیه‌شده هستید. اگر v22.14.x یا بالاتر را چاپ کند، روی مسیر پشتیبانی‌شده Node 22 LTS هستید، اما همچنان توصیه می‌کنیم هر زمان مناسب بود به Node 24 ارتقا دهید. اگر Node نصب نیست یا نسخه آن بیش از حد قدیمی است، یکی از روش‌های نصب زیر را انتخاب کنید.

نصب Node

**Homebrew** (توصیه‌شده):

```bash
brew install node
```

یا نصب‌کننده macOS را از [nodejs.org](https://nodejs.org/) دانلود کنید.

**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
```

یا از یک مدیر نسخه استفاده کنید (پایین را ببینید).

**winget** (توصیه‌شده):

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

یا نصب‌کننده Windows را از [nodejs.org](https://nodejs.org/) دانلود کنید.

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

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

نمونه با fnm:

fnm install 24
fnm use 24

مطمئن شوید مدیر نسخه شما در فایل راه‌اندازی shell مقداردهی اولیه شده است (`~/.zshrc` یا `~/.bashrc`). اگر این‌طور نباشد، ممکن است `openclaw` در sessionهای جدید ترمینال پیدا نشود، چون PATH شامل دایرکتوری bin مربوط به Node نخواهد بود.

عیب‌یابی

openclaw: command not found

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

```bash npm prefix -g ``` ```bash echo "$PATH" ```

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

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

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

    سپس یک ترمینال جدید باز کنید (یا در zsh دستور `rehash` / در bash دستور `hash -r` را اجرا کنید).
  </Tab>
  <Tab title="Windows">
    خروجی `npm prefix -g` را از طریق Settings → System → Environment Variables به PATH سیستم خود اضافه کنید.
  </Tab>
</Tabs>

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

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