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¶

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.
````

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.

bash npm prefix -g bash echo "$PATH"

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

~/.zshrc veya ~/.bashrc dosyasına ekleyin:

    ```
        ```bash
        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).
      </Tab>
      <Tab title="Windows">
        `npm prefix -g` çıktısını Ayarlar → Sistem → Ortam Değişkenleri üzerinden sistem PATH’inize ekleyin.
      </Tab>
    </Tabs>
    ```

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.