Node.js

OpenClaw, Node 22 veya daha yeni bir sürüm gerektirir. Yükleyici betik Node’u otomatik olarak algılar ve yükler — bu sayfa, Node’u kendiniz kurmak ve her şeyin doğru şekilde bağlandığından emin olmak (sürümler, PATH, global yüklemeler) istediğiniz durumlar içindir.

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

node -v

Bu komut v22.x.x veya daha yeni bir sürüm yazdırıyorsa sorun yok. Node yüklü değilse veya sürüm çok eskiyse, aşağıdan bir yükleme yöntemi seçin.

Node’u yükleyin

macOS
Linux
Windows

Homebrew (önerilen):

````
```bash
brew install node
```

Ya da macOS yükleyicisini [nodejs.org](https://nodejs.org/) üzerinden indirin.
````

Ubuntu / Debian:

````
```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

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

winget (önerilen):

````
```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Ya da Windows yükleyicisini [nodejs.org](https://nodejs.org/) üzerinden indirin.
````

Using a version manager (nvm, fnm, mise, asdf)

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ı, çapraz platform
nvm — macOS/Linux’te yaygın
mise — çok dilli (Node, Python, Ruby, vb.)

fnm ile örnek:

fnm install 22
fnm use 22

Sürüm yöneticinizin kabuk başlangıç dosyanızda (~/.zshrc veya ~/.bashrc) başlatıldığından emin olun. Aksi halde, 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.

Find your global npm prefix

npm prefix -g

Check if it's on your PATH

echo "$PATH"

```
Çıktıda `<npm-prefix>/bin`’yı (macOS/Linux) veya `<npm-prefix>`’yi (Windows) arayın.
```

Add it to your shell startup file

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’te rehash, bash’te hash -r çalıştırın).

npm prefix -g çıktısını Ayarlar → Sistem → Ortam Değişkenleri üzerinden sistem PATH’inize ekleyin.

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

EACCES hataları görüyorsanız, npm’in global önekini kullanıcı tarafından yazılabilir bir dizine değiştirin:

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.

Yardım

Topluluk

Ortam ve hata ayıklama

Node çalışma zamanı

Sıkıştırma iç yapısı

Geliştirici kurulumu

Doküman meta bilgisi

Node.js

Node.js

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

Node’u yükleyin

Sorun Giderme

`openclaw: command not found`

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

Yardım

Topluluk

Ortam ve hata ayıklama

Node çalışma zamanı

Sıkıştırma iç yapısı

Geliştirici kurulumu

Doküman meta bilgisi

​Node.js

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

​Node’u yükleyin

​Sorun Giderme

​openclaw: command not found

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

Node.js

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

Node’u yükleyin

Sorun Giderme

`openclaw: command not found`

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