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.19+, Node 23.11+ veya Node 24+ gereklidir. 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. Kurulum betiği Node'u otomatik olarak algılar ve kurar. Node'u kendiniz yapılandırmak istediğinizde (sürümler, PATH, genel kurulumlar) bu sayfayı kullanın.

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

bash
node -v

Önerilen varsayılan sürüm v24.x.x veya üzeridir. Desteklenen Node 22 LTS yolu v22.19.x veya üzeridir (uygun olduğunda Node 24'e yükseltin). v23.11.0 öncesindeki Node 23 derlemeleri desteklenmez. Node yüklü değilse veya desteklenen aralığın dışındaysa aşağıdaki kurulum yöntemlerinden birini 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ı, 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 genel ikili dosya 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 sırasında izin hataları (Linux)

    EACCES hataları görürseniz npm'in genel önekini kullanıcının yazabildiği 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?
    On this page

    On this page