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

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
Linux
Windows

Homebrew (önerilen):

brew install node

Alternatif olarak macOS yükleyicisini nodejs.org adresinden indirin.

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

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

winget (önerilen):

winget install OpenJS.NodeJS.LTS

Chocolatey:

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:

fnm install 24
fnm use 24

Sürüm yöneticinizi kabuk başlangıç dosyanızda (~/.zshrc veya ~/.bashrc) başlatın. Bu adımı atlarsanız PATH, Node’un bin dizinini içermeyeceğinden yeni terminal oturumlarında openclaw bulunamayabilir.

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

npm prefix -g

PATH'inizde olup olmadığını kontrol edin

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
Windows

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

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).

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:

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

Kuruluma Genel Bakış - tüm kurulum yöntemleri
Güncelleme - OpenClaw’ı güncel tutma
Başlarken - kurulumdan sonraki ilk adımlar

Install overview

Maintenance

Containers

Hosting

Advanced setup

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

Node’u kurun

Sorun giderme

`openclaw: command not found`

`npm install -g` üzerinde izin hataları (Linux)

İlgili

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

​Node’u kurun

​Sorun giderme

​openclaw: command not found

​npm install -g üzerinde izin hataları (Linux)

​İlgili

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

Node’u kurun

Sorun giderme

`openclaw: command not found`

`npm install -g` üzerinde izin hataları (Linux)

İlgili