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

Install overview

Node.js

OpenClaw için Node 22.22.3+, Node 24.15+ veya Node 25.9+ gerekir. 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 serisi üzerinden desteklenmeye devam eder. Node 23 desteklenmez. Yükleyici betiği, Node'u otomatik olarak algılar ve kurar — Node'u kendiniz ayarlamak istediğinizde (sürümler, PATH, global kurulumlar) bu sayfayı kullanın.

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

bash
node -v

v24.15.0 veya daha yeni bir 24.x sürümü, önerilen varsayılandır. v22.22.3 veya daha yeni bir 22.x sürümü, desteklenen Node 22 LTS yoludur; Node v25.9.0+ de desteklenir. Node 23 desteklenmez. Node yüklü değilse veya desteklenen aralığın dışındaysa aşağıdan bir kurulum yöntemi seçin.

Node'u kurun

macOS

Homebrew (önerilir):

bash
brew install node

Alternatif olarak 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

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 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. Yaygın seçenekler:

  • fnm - hızlı ve platformlar arası
  • nvm - macOS/Linux'ta 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 önekinizi 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) değerini 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'de rehash / bash'te hash -r komutunu çalıştırın).

    Windows

    npm prefix -g çıktısını Settings → System → Environment Variables üzerinden sistem PATH'inize ekleyin.

    • npm install -g sırasında izin hataları (Linux)

    EACCES hataları görürseniz npm'in global önekini kullanıcı tarafından yazılabilir bir dizine geçirin:

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

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

    İlgili içerikler

    Was this useful?
    On this page

    On this page