Ana içeriğe atla

​
Node.js

OpenClaw, Node 22.14 veya daha yenisini 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ılar ve yükler — 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, genel kurulumlar).

​
Sürümünüzü denetleyin

node -v
Bu komut v24.x.x veya daha yüksek bir sürüm yazdırıyorsa önerilen varsayılanı kullanıyorsunuz. v22.14.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. Node kurulu değilse veya sürüm çok eskiyse, aşağıdaki kurulum yöntemlerinden birini seçin.

​
Node’u yükleyin

Homebrew (önerilir):
brew install node
Veya 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 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ılmadıysa, PATH Node’un bin dizinini içermeyeceğinden yeni terminal oturumlarında openclaw bulunamayabilir.

​
Sorun giderme

​
openclaw: command not found

Bu neredeyse her zaman npm’nin genel bin dizininin PATH üzerinde olmadığı anlamına gelir.
1

Genel npm prefix'inizi bulun

npm prefix -g
2

PATH üzerinde olup olmadığını denetleyin

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 şunu ekleyin:
export PATH="$(npm prefix -g)/bin:$PATH"
Ardından yeni bir terminal açın (veya zsh’de rehash, bash’te hash -r çalıştırın).

​
npm install -g sırasında izin hataları (Linux)

EACCES hataları görüyorsanız, npm’nin genel 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ı olması için export PATH=... satırını ~/.bashrc veya ~/.zshrc dosyanıza ekleyin.

​
İlgili