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 veya daha yeni bir sürüm gerektirir. Node 24, kurulumlar, CI ve sürüm iş akışları için varsayılan ve önerilen çalışma zamanıdır. Node 22, aktif LTS hattı üzerinden desteklenmeye devam eder. Kurulum betiği, Node'u otomatik olarak algılayıp kurar - bu sayfa, Node'u kendiniz kurmak ve her şeyin doğru bağlandığından emin olmak istediğiniz durumlar içindir (sürümler, PATH, global kurulumlar).

Sürümünüzü kontrol edin

bash
node -v

Bu komut v24.x.x veya daha yüksek bir sürüm yazdırırsa önerilen varsayılandasınız. v22.16.x veya daha yüksek bir sürüm yazdırırsa desteklenen Node 22 LTS yolundasınız, ancak uygun olduğunda Node 24'e yükseltmenizi yine de öneririz. Node kurulu değilse veya sürüm çok eskiyse aşağıdan bir kurulum yöntemi seçin.

Node'u kurun

macOS

Homebrew (önerilir):

bash
brew install node

Alternatif olarak macOS kurulum aracını nodejs.org adresinden indirin.

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

Alternatif olarak bir sürüm yöneticisi kullanın (aşağıya bakın).

Windows

winget (önerilir):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Alternatif olarak Windows kurulum aracını nodejs.org adresinden indirin.

Bir sürüm yöneticisi kullanma (nvm, fnm, mise, asdf)

Sürüm yöneticileri, Node sürümleri arasında kolayca geçiş yapmanızı sağlar. Popüler seçenekler:

  • fnm - hızlı, platformlar arası
  • nvm - macOS/Linux üzerinde yaygın olarak kullanılır
  • mise - çok dilli (Node, Python, Ruby vb.)

fnm ile örnek:

bash
fnm install 24fnm use 24

Sorun giderme

openclaw: command not found

Bu neredeyse her zaman npm'in global bin dizininin PATH'inizde olmadığı anlamına gelir.

  • Global npm prefix değerini bulun

    bash
    npm prefix -g

  • PATH'inizde olup olmadığını kontrol edin

    bash
    echo "$PATH"

    Çıktıda <npm-prefix>/bin (macOS/Linux) veya <npm-prefix> (Windows) arayın.

  • Kabuk başlangıç dosyanıza ekleyin

    macOS / Linux

    ~/.zshrc veya ~/.bashrc dosyasına ekleyin:

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

    Ardından yeni bir terminal açın (veya zsh içinde rehash / bash içinde hash -r çalıştırın).

    Windows

    npm prefix -g çıktısını Ayarlar → Sistem → Ortam Değişkenleri üzerinden sistem PATH'inize ekleyin.

    • npm install -g üzerinde izin hataları (Linux)

    EACCES hataları görürseniz npm'in global prefix değerini kullanıcı tarafından yazılabilir bir dizine taşıyın:

    bash
    mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

    Kalıcı hale getirmek için export PATH=... satırını ~/.bashrc veya ~/.zshrc dosyanıza ekleyin.

    İlgili

    Was this useful?