OpenClawDocs
در این صفحه

در این صفحه

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Runtimes

Node.js

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

بررسی نسخه

bash
node -v

v24.15.0 یا نسخه جدیدتر 24.x، پیش‌فرض توصیه‌شده است. v22.22.3 یا نسخه جدیدتر 22.x، مسیر پشتیبانی‌شده Node 22 LTS است؛ Node v25.9.0+ نیز پشتیبانی می‌شود. Node 23 پشتیبانی نمی‌شود. اگر 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 دانلود کنید.

استفاده از مدیر نسخه (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 شما قرار ندارد.

  • پیشوند سراسری npm را پیدا کنید

    bash
    npm prefix -g

  • بررسی کنید که در PATH شما باشد

    bash
    echo "$PATH"

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

  • آن را به فایل راه‌اندازی پوسته خود اضافه کنید

    macOS / Linux

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

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

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

    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?