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+ veya Node 24+ 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, etkin LTS hattı üzerinden desteklenmeye devam eder. Yükleyici 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ıyorsa önerilen varsayılan sürümdesiniz. v22.19.x veya daha yüksek bir sürüm yazdırıyorsa desteklenen Node 22 LTS yolundasınız, ancak uygun olduğunda yine de Node 24’e yükseltmenizi öneririz. v23.11.0 öncesindeki Node 23 sürümleri desteklenmez. Node kurulu değilse veya sürüm desteklenen aralığın dışındaysa aşağıdan bir kurulum yöntemi seçin.

Node’u kurun

macOS

Homebrew (önerilir):

bash
brew install node

Ya da macOS yükleyicisini 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

Ya da 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

Ya da Windows yükleyicisini nodejs.org adresinden indirin.

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’inizi 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’ini 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?
    On this page

    On this page