Kurulum¶

Başlarken adımını zaten tamamladınız mı? Hazırsınız — bu sayfa alternatif kurulum yöntemleri, platforma özgü talimatlar ve bakım içindir.

Sistem gereksinimleri¶

• Node 22+ (eksikse yükleyici betiği kurar)
• macOS, Linux veya Windows
• CLI’yi indirir, npm ile global olarak kurar ve tanıtım sihirbazını başlatır.

Windows'ta OpenClaw'ı WSL2 altında çalıştırmanızı önemle öneririz.

Kurulum yöntemleri¶

Yükleyici betiği, OpenClaw'ı kurmanın önerilen yoludur. Node algılama, kurulum ve ilk katılımı tek adımda gerçekleştirir.

Betik

```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

Hepsi bu — betik Node algılama, kurulum ve ilk katılımı yönetir.

İlk katılımı atlayıp yalnızca ikiliyi kurmak için:

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

Tüm bayraklar, ortam değişkenleri ve CI/otomasyon seçenekleri için [Yükleyici iç detayları](/install/installer) sayfasına bakın.
```

Zaten Node 22+ yüklüyse ve kurulumu kendiniz yönetmek istiyorsanız:

```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="sharp derleme hataları mı?">
      libvips'i küresel olarak kuruluysa (macOS'ta Homebrew ile yaygındır) ve `sharp` başarısız oluyorsa, önceden derlenmiş ikilileri zorlayın:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      `sharp: Please add node-gyp to your dependencies` görürseniz, ya derleme araçlarını kurun (macOS: Xcode CLT + `npm install -g node-gyp`) ya da yukarıdaki ortam değişkenini kullanın.
    </Accordion>
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    pnpm, derleme betikleri olan paketler için açık onay gerektirir. İlk kurulumda "Ignored build scripts" uyarısı göründükten sonra `pnpm approve-builds -g` komutunu çalıştırın ve listelenen paketleri seçin.
    </Note>
  </Tab>
</Tabs>
```

Katkıda bulunanlar veya yerel bir kopyadan çalıştırmak isteyen herkes için.

```
<Steps>
  <Step title="Klonla ve derle">
    [OpenClaw deposunu](https://github.com/openclaw/openclaw) klonlayın ve derleyin:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  </Step>
  <Step title="CLI'yi bağla">
    `openclaw` komutunu küresel olarak kullanılabilir yapın:

    ```bash
    pnpm link --global
    ```

    Alternatif olarak, bağlantıyı atlayıp komutları depo içinden `pnpm openclaw ...` ile çalıştırabilirsiniz.
  </Step>
  <Step title="İlk katılımı çalıştır">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

Daha derin geliştirme iş akışları için [Kurulum](/start/setup) sayfasına bakın.
```

Diğer kurulum yöntemleri¶

Konteynerleştirilmiş veya başsız dağıtımlar. Nix ile bildirime dayalı kurulum. Otomatik filo sağlama. Bun çalışma zamanı üzerinden yalnızca CLI kullanımı.

Kurulumdan sonra¶

Her şeyin çalıştığını doğrulayın:

openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

If you need custom runtime paths, use:

• OPENCLAW_HOME for home-directory based internal paths
• OPENCLAW_STATE_DIR for mutable state location
• OPENCLAW_CONFIG_PATH for config file location

See Environment vars for precedence and full details.

Sorun Giderme: openclaw bulunamadı¶

Hızlı tanı:

node -v
npm -v
npm prefix -g
echo "$PATH"

$(npm prefix -g)/bin (macOS/Linux) veya $(npm prefix -g) (Windows) PATH'inizde ($PATH) değilse, kabuğunuz küresel npm ikililerini ( openclaw dahil) bulamaz.

Düzeltme — kabuk başlangıç dosyanıza (~/.zshrc veya ~/.bashrc) ekleyin:

export PATH="$(npm prefix -g)/bin:$PATH"

Windows'ta, npm prefix -g çıktısını PATH'inize ekleyin.

Ardından yeni bir terminal açın (veya zsh'te rehash / bash'te hash -r).

Güncelleme / kaldırma¶

OpenClaw'ı güncel tutun. Yeni bir makineye geçin. OpenClaw'ı tamamen kaldırın.