Ana içeriğe atla
OpenClaw, Node 22.19+, Node 23.11+ veya Node 24+ 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 hattı üzerinden desteklenmeye devam eder. Yükleyici betiği Node’u otomatik olarak algılayıp kurar - bu sayfa, Node’u kendiniz kurmak ve her şeyin doğru bağlandığından emin olmak istediğiniz durumlar içindir (sürümler, PATH, global kurulumlar).

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

node -v
Bu komut v24.x.x veya daha yüksek bir sürüm yazdırıyorsa önerilen varsayılan sürümdesiniz. v22.19.x veya daha yüksek bir sürüm yazdırıyorsa desteklenen Node 22 LTS yolundasınız, ancak uygun olduğunda yine de Node 24’e yükseltmenizi öneririz. v23.11.0 öncesindeki Node 23 sürümleri desteklenmez. Node kurulu değilse veya sürüm desteklenen aralığın dışındaysa aşağıdan bir kurulum yöntemi seçin.

​
Node’u kurun

Homebrew (önerilir):
brew install node
Ya da macOS yükleyicisini nodejs.org adresinden indirin.
Sürüm yöneticileri, Node sürümleri arasında kolayca geçiş yapmanızı sağlar. Popüler 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:
fnm install 24
fnm use 24
Sürüm yöneticinizin kabuk başlangıç dosyanızda (~/.zshrc veya ~/.bashrc) başlatıldığından emin olun. Başlatılmamışsa, PATH Node’un bin dizinini içermeyeceği için yeni terminal oturumlarında openclaw bulunamayabilir.

​
Sorun giderme

​
openclaw: command not found

Bu neredeyse her zaman npm’in global bin dizininin PATH’inizde olmadığı anlamına gelir.
1

Global npm prefix’inizi bulun

npm prefix -g
2

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

echo "$PATH"
Çıktıda <npm-prefix>/bin (macOS/Linux) veya <npm-prefix> (Windows) arayın.
3

Kabuk başlangıç dosyanıza ekleyin

~/.zshrc veya ~/.bashrc dosyasına ekleyin:
export PATH="$(npm prefix -g)/bin:$PATH"
Ardından yeni bir terminal açın (veya zsh içinde rehash / bash içinde hash -r çalıştırın).

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

EACCES hataları görürseniz npm’in global prefix’ini kullanıcı tarafından yazılabilir bir dizine taşıyın: 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
Kalıcı hale getirmek için export PATH=... satırını ~/.bashrc veya ~/.zshrc dosyanıza ekleyin.

​
İlgili