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

Install overview

Node.js

OpenClaw Node 22.14 veya daha yeni bir sürüm gerektirir. Node 24; kurulumlar, CI ve yayın iş akışları için varsayılan ve önerilen çalışma zamanıdır. Node 22, etkin 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 şekilde bağlandığından emin olmak istediğiniz durumlar içindir (sürümler, PATH, global kurulumlar).

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

node -v

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

Node'u kurun

macOS

Homebrew (önerilir):

brew install node

Ya da macOS kurulum paketini nodejs.org adresinden indirin.

Linux

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

sudo dnf install nodejs

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

Windows

winget (önerilir):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Ya da Windows kurulum paketini nodejs.org adresinden indirin.

Using a version manager (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ı, çapraz platform
  • nvm - macOS/Linux üzerinde yaygın olarak kullanılır
  • mise - çok dilli (Node, Python, Ruby vb.)

fnm ile örnek:

fnm install 24
fnm use 24

Sorun giderme

openclaw: command not found

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

  • Find your global npm prefix

    npm prefix -g

  • Check if it's on your PATH

    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

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

    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'ini kullanıcı tarafından yazılabilir bir dizine geçirin:

    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