Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw, Node 22.16 veya daha yeni bir sürüm 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, aktif LTS hattı üzerinden desteklenmeye devam eder. Kurulum 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ırsa önerilen varsayılandasınız. v22.16.x veya daha yüksek bir sürüm yazdırırsa desteklenen Node 22 LTS yolundasınız, ancak uygun olduğunda Node 24’e yükseltmenizi yine de öneririz. Node kurulu değilse veya sürüm çok eskiyse aşağıdan bir kurulum yöntemi seçin.

​
Node’u kurun

Homebrew (önerilir):
brew install node
Alternatif olarak macOS kurulum aracını 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ılmadıysa, 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 değerini 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 değerini 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