OpenClawDocs
Bu sayfada

Bu sayfada

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+ veya Node 25.9+ 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 serisi aracılığıyla desteklenmeye devam eder. Node 23 desteklenmez. Kurulum betiği, Node'u otomatik olarak algılar ve kurar. Node'u kendiniz ayarlamak istediğinizde (sürümler, PATH, genel 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 kurulu değilse veya desteklenen aralığın dışındaysa aşağıdaki kurulum yöntemlerinden birini seçin.

Node'u kurun

macOS

Homebrew (önerilen):

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 (önerilen):

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 ü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 durum neredeyse her zaman npm'in genel bin dizininin PATH'inizde olmadığı anlamına gelir.

  • Genel 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 üzerinde izin hataları (Linux)

    EACCES hataları görürseniz npm'in genel ö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

    Was this useful?