---
read_when:
    - OpenClaw'ı kurmadan önce Node.js kurmanız gerekiyor
    - OpenClaw'ı kurdunuz ama `openclaw` komutu bulunamıyor
    - '`npm install -g` izin veya PATH sorunlarıyla başarısız oluyor'
summary: OpenClaw için Node.js kurun ve yapılandırın — sürüm gereksinimleri, kurulum seçenekleri ve PATH sorun giderme
title: Node.js
x-i18n:
    generated_at: "2026-04-24T09:17:03Z"
    model: gpt-5.4
    provider: openai
    source_hash: 99c72b917fa8beba136ee6010799c0183cff8b2420b5a1bd256d9155e50f065a
    source_path: install/node.md
    workflow: 15
---

OpenClaw **Node 22.14 veya daha yenisini** gerektirir. Kurulumlar, CI ve sürüm iş akışları için **Node 24 varsayılan ve önerilen çalışma zamanıdır**. Node 22, etkin LTS hattı üzerinden desteklenmeye devam eder. [Yükleyici betiği](/tr/install#alternative-install-methods), Node'u otomatik olarak algılar ve 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

```bash
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 kurun

<Tabs>
  <Tab title="macOS">
    **Homebrew** (önerilir):

    ```bash
    brew install node
    ```

    Veya macOS yükleyicisini [nodejs.org](https://nodejs.org/) adresinden indirin.

  </Tab>
  <Tab title="Linux">
    **Ubuntu / Debian:**

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

    **Fedora / RHEL:**

    ```bash
    sudo dnf install nodejs
    ```

    Veya bir sürüm yöneticisi kullanın (aşağıya bakın).

  </Tab>
  <Tab title="Windows">
    **winget** (önerilir):

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

    **Chocolatey:**

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

    Veya Windows yükleyicisini [nodejs.org](https://nodejs.org/) adresinden indirin.

  </Tab>
</Tabs>

<Accordion title="Sürüm yöneticisi kullanma (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**](https://github.com/Schniz/fnm) — hızlı, platformlar arası
- [**nvm**](https://github.com/nvm-sh/nvm) — macOS/Linux üzerinde yaygın kullanılır
- [**mise**](https://mise.jdx.dev/) — çok dilli (Node, Python, Ruby vb.)

fnm ile örnek:

```bash
fnm install 24
fnm use 24
```

  <Warning>
  Sürüm yöneticinizin kabuk başlangıç dosyanızda (`~/.zshrc` veya `~/.bashrc`) başlatıldığından emin olun. Başlatılmazsa, PATH Node'un bin dizinini içermeyeceğinden yeni terminal oturumlarında `openclaw` bulunamayabilir.
  </Warning>
</Accordion>

## Sorun giderme

### `openclaw: command not found`

Bu neredeyse her zaman npm'nin global bin dizininin PATH üzerinde olmadığı anlamına gelir.

<Steps>
  <Step title="Global npm prefix'inizi bulun">
    ```bash
    npm prefix -g
    ```
  </Step>
  <Step title="PATH üzerinde olup olmadığını kontrol edin">
    ```bash
    echo "$PATH"
    ```

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

  </Step>
  <Step title="Bunu kabuk başlangıç dosyanıza ekleyin">
    <Tabs>
      <Tab title="macOS / Linux">
        `~/.zshrc` veya `~/.bashrc` dosyasına ekleyin:

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

  </Step>
</Steps>

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

`EACCES` hataları görüyorsanız, npm'nin global prefix'ini kullanıcı tarafından yazılabilir bir dizine taşıyın:

```bash
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
```

Bunu kalıcı yapmak için `export PATH=...` satırını `~/.bashrc` veya `~/.zshrc` dosyanıza ekleyin.

## İlgili

- [Install Overview](/tr/install) — tüm kurulum yöntemleri
- [Updating](/tr/install/updating) — OpenClaw'ı güncel tutma
- [Getting Started](/tr/start/getting-started) — kurulum sonrası ilk adımlar
