Install overview
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 -vv24.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):
brew install nodeAlternatif olarak macOS yükleyicisini nodejs.org adresinden indirin.
Linux
Ubuntu / Debian:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejsFedora / RHEL:
sudo dnf install nodejsAlternatif olarak bir sürüm yöneticisi kullanın (aşağıya bakın).
Windows
winget (önerilen):
winget install OpenJS.NodeJS.LTSChocolatey:
choco install nodejs-ltsAlternatif 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 24fnm use 24Sorun 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 -gPATH'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
~/.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).
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:
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
