docs/docs/tr/install/installer.md

read_when	summary	title	x-i18n
`openclaw.ai/install.sh` anlamak istiyorsunuz Kurulumları otomatikleştirmek istiyorsunuz (CI / headless) Bir GitHub checkout'undan kurulum yapmak istiyorsunuz	Yükleyici betiklerin nasıl çalıştığı (`install.sh`, `install-cli.sh`, `install.ps1`), bayraklar ve otomasyon	Yükleyici iç yapısı	generated_at model provider source_hash source_path workflow 2026-04-26T11:34:09Z gpt-5.4 openai a1f932fb3713e8ecfa75215b05d7071b3b75e6d1135d7c326313739f294023e2 install/installer.md 15

OpenClaw, openclaw.ai üzerinden sunulan üç yükleyici betikle gelir.

Betik	Platform	Ne yapar
install.sh	macOS / Linux / WSL	Gerekirse Node kurar, OpenClaw'ı npm (varsayılan) veya git ile kurar ve onboarding çalıştırabilir.
install-cli.sh	macOS / Linux / WSL	Node + OpenClaw'ı yerel bir önek altına (~/.openclaw) npm veya git checkout modlarıyla kurar. Root gerekmez.
install.ps1	Windows (PowerShell)	Gerekirse Node kurar, OpenClaw'ı npm (varsayılan) veya git ile kurar ve onboarding çalıştırabilir.

Hızlı komutlar

```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash ```

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help
```

```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash ```

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help
```

```powershell iwr -useb https://openclaw.ai/install.ps1 | iex ```

```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun
```

Kurulum başarılı olduysa ama yeni bir terminalde `openclaw` bulunamıyorsa bkz. [Node.js sorun giderme](/tr/install/node#troubleshooting).

---

install.sh

macOS/Linux/WSL üzerinde çoğu etkileşimli kurulum için önerilir.

Akış (install.sh)

macOS ve Linux'u (WSL dahil) destekler. macOS algılanırsa Homebrew yoksa kurar. Node sürümünü denetler ve gerekirse Node 24 kurar (macOS'ta Homebrew, Linux apt/dnf/yum üzerinde NodeSource kurulum betikleri). OpenClaw, uyumluluk için hâlâ Node 22 LTS'yi, şu anda `22.14+`, destekler. Git yoksa kurar. - `npm` yöntemi (varsayılan): genel npm kurulumu - `git` yöntemi: depoyu clone/update eder, bağımlılıkları pnpm ile kurar, build alır, sonra `~/.local/bin/openclaw` konumuna wrapper kurar - Yüklü bir gateway hizmetini best-effort olarak yeniler (`openclaw gateway install --force`, sonra restart) - Yükseltmelerde ve git kurulumlarında `openclaw doctor --non-interactive` çalıştırır (best effort) - Uygun olduğunda onboarding dener (TTY mevcut, onboarding devre dışı değil ve bootstrap/config denetimleri geçiyorsa) - Varsayılan olarak `SHARP_IGNORE_GLOBAL_LIBVIPS=1` ayarlar

Kaynak checkout algılama

Bir OpenClaw checkout'u içinde çalıştırılırsa (package.json + pnpm-workspace.yaml), betik şunları sunar:

• checkout'u kullan (git), veya
• genel kurulumu kullan (npm)

TTY yoksa ve hiçbir kurulum yöntemi ayarlanmamışsa varsayılan olarak npm kullanır ve uyarı verir.

Betik, geçersiz yöntem seçimi veya geçersiz --install-method değerleri için 2 koduyla çıkar.

Örnekler (install.sh)

```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --version main ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run ```

Bayrak	Açıklama
--install-method npm|git	Kurulum yöntemini seç (varsayılan: npm). Takma ad: --method
--npm	npm yöntemi için kısayol
--git	git yöntemi için kısayol. Takma ad: --github
--version <version|dist-tag|spec>	npm sürümü, dist-tag veya paket spec'i (varsayılan: latest)
--beta	Varsa beta dist-tag kullan, yoksa latest değerine fallback yap
--git-dir <path>	Checkout dizini (varsayılan: ~/openclaw). Takma ad: --dir
--no-git-update	Mevcut checkout için git pull atla
--no-prompt	İstemleri devre dışı bırak
--no-onboard	Onboarding'i atla
--onboard	Onboarding'i etkinleştir
--dry-run	Değişiklik uygulamadan eylemleri yazdır
--verbose	Hata ayıklama çıktısını etkinleştir (set -x, npm notice düzeyi günlükler)
--help	Kullanımı göster (-h)

Değişken	Açıklama
OPENCLAW_INSTALL_METHOD=git|npm	Kurulum yöntemi
OPENCLAW_VERSION=latest|next|main|<semver>|<spec>	npm sürümü, dist-tag veya paket spec'i
OPENCLAW_BETA=0|1	Varsa beta kullan
OPENCLAW_GIT_DIR=<path>	Checkout dizini
OPENCLAW_GIT_UPDATE=0|1	Git güncellemelerini aç/kapat
OPENCLAW_NO_PROMPT=1	İstemleri devre dışı bırak
OPENCLAW_NO_ONBOARD=1	Onboarding'i atla
OPENCLAW_DRY_RUN=1	Dry run modu
OPENCLAW_VERBOSE=1	Hata ayıklama modu
OPENCLAW_NPM_LOGLEVEL=error|warn|notice	npm günlük düzeyi
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1	sharp/libvips davranışını denetle (varsayılan: 1)

---

install-cli.sh

Her şeyi yerel bir önek altında (varsayılan `~/.openclaw`) ve sistem Node bağımlılığı olmadan istediğiniz ortamlar için tasarlanmıştır. Varsayılan olarak npm kurulumlarını, ayrıca aynı önek akışı altında git checkout kurulumlarını destekler.

Akış (install-cli.sh)

Sabitlenmiş desteklenen bir Node LTS tarball'ını (sürüm betik içine gömülüdür ve bağımsız güncellenir) `/tools/node-v` konumuna indirir ve SHA-256 doğrulaması yapar. Git yoksa Linux'ta apt/dnf/yum veya macOS'ta Homebrew üzerinden kurmayı dener. - `npm` yöntemi (varsayılan): önek altına npm ile kurar, sonra wrapper'ı `/bin/openclaw` konumuna yazar - `git` yöntemi: bir checkout'u clone/update eder (varsayılan `~/openclaw`) ve yine wrapper'ı `/bin/openclaw` konumuna yazar Aynı önekten yüklenmiş bir gateway hizmeti zaten varsa, betik `openclaw gateway install --force`, sonra `openclaw gateway restart` çalıştırır ve gateway sağlığını best-effort olarak probe eder.

Örnekler (install-cli.sh)

```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard ```

Bayrak	Açıklama
--prefix <path>	Kurulum öneki (varsayılan: ~/.openclaw)
--install-method npm|git	Kurulum yöntemini seç (varsayılan: npm). Takma ad: --method
--npm	npm yöntemi için kısayol
--git, --github	git yöntemi için kısayol
--git-dir <path>	Git checkout dizini (varsayılan: ~/openclaw). Takma ad: --dir
--version <ver>	OpenClaw sürümü veya dist-tag (varsayılan: latest)
--node-version <ver>	Node sürümü (varsayılan: 22.22.0)
--json	NDJSON olayları yayar
--onboard	Kurulumdan sonra openclaw onboard çalıştır
--no-onboard	Onboarding'i atla (varsayılan)
--set-npm-prefix	Linux'ta, geçerli önek yazılabilir değilse npm önekini ~/.npm-global olarak zorla
--help	Kullanımı göster (-h)

Değişken	Açıklama
OPENCLAW_PREFIX=<path>	Kurulum öneki
OPENCLAW_INSTALL_METHOD=git|npm	Kurulum yöntemi
OPENCLAW_VERSION=<ver>	OpenClaw sürümü veya dist-tag
OPENCLAW_NODE_VERSION=<ver>	Node sürümü
OPENCLAW_GIT_DIR=<path>	Git kurulumları için checkout dizini
OPENCLAW_GIT_UPDATE=0|1	Mevcut checkout'lar için git güncellemelerini aç/kapat
OPENCLAW_NO_ONBOARD=1	Onboarding'i atla
OPENCLAW_NPM_LOGLEVEL=error|warn|notice	npm günlük düzeyi
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1	sharp/libvips davranışını denetle (varsayılan: 1)

---

install.ps1

Akış (install.ps1)

PowerShell 5+ gerektirir. Eksikse önce winget, sonra Chocolatey, sonra Scoop üzerinden kurmayı dener. Node 22 LTS, şu anda `22.14+`, uyumluluk için desteklenmeye devam eder. - `npm` yöntemi (varsayılan): seçili `-Tag` kullanılarak genel npm kurulumu - `git` yöntemi: depoyu clone/update eder, pnpm ile kurulum/build yapar ve wrapper'ı `%USERPROFILE%\.local\bin\openclaw.cmd` konumuna kurar - Mümkün olduğunda gerekli bin dizinini kullanıcı PATH'ine ekler - Yüklü bir gateway hizmetini best-effort olarak yeniler (`openclaw gateway install --force`, sonra restart) - Yükseltmelerde ve git kurulumlarında `openclaw doctor --non-interactive` çalıştırır (best effort) `iwr ... | iex` ve scriptblock kurulumları, mevcut PowerShell oturumunu kapatmadan sonlandırıcı hata bildirir. Doğrudan `powershell -File` / `pwsh -File` kurulumları ise otomasyon için yine sıfır olmayan kodla çıkar.

Örnekler (install.ps1)

```powershell iwr -useb https://openclaw.ai/install.ps1 | iex ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag main ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw" ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun ``` ```powershell # install.ps1 için henüz özel bir -Verbose bayrağı yok. Set-PSDebug -Trace 1 & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard Set-PSDebug -Trace 0 ```

Bayrak	Açıklama
-InstallMethod npm|git	Kurulum yöntemi (varsayılan: npm)
-Tag <tag|version|spec>	npm dist-tag, sürüm veya paket spec'i (varsayılan: latest)
-GitDir <path>	Checkout dizini (varsayılan: %USERPROFILE%\openclaw)
-NoOnboard	Onboarding'i atla
-NoGitUpdate	git pull atla
-DryRun	Yalnızca eylemleri yazdır

Değişken	Açıklama
OPENCLAW_INSTALL_METHOD=git|npm	Kurulum yöntemi
OPENCLAW_GIT_DIR=<path>	Checkout dizini
OPENCLAW_NO_ONBOARD=1	Onboarding'i atla
OPENCLAW_GIT_UPDATE=0	Git pull'u devre dışı bırak
OPENCLAW_DRY_RUN=1	Dry run modu

`-InstallMethod git` kullanılırsa ve Git eksikse betik çıkar ve Git for Windows bağlantısını yazdırır.

---

CI ve otomasyon

Öngörülebilir çalıştırmalar için etkileşimsiz bayraklar/ortam değişkenleri kullanın.

```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard ``` ```bash OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \ curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash ``` ```bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard ```

---

Sorun giderme

`git` kurulum yöntemi için Git gereklidir. `npm` kurulumlarında bile, bağımlılıklar git URL'leri kullandığında `spawn git ENOENT` hatalarını önlemek için Git yine de denetlenir/kurulur. Bazı Linux kurulumlarında npm genel öneki root sahibi yolları işaret eder. `install.sh`, öneki `~/.npm-global` olarak değiştirebilir ve kabuk rc dosyalarına PATH dışa aktarımları ekleyebilir (bu dosyalar varsa). Betikler, sharp'ın sistem libvips'e karşı build almasını önlemek için varsayılan olarak `SHARP_IGNORE_GLOBAL_LIBVIPS=1` ayarlar. Geçersiz kılmak için:

```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```

Git for Windows'u kurun, PowerShell'i yeniden açın, yükleyiciyi yeniden çalıştırın. `npm config get prefix` çalıştırın ve bu dizini kullanıcı PATH'inize ekleyin (Windows'ta `\bin` son eki gerekmez), sonra PowerShell'i yeniden açın. `install.ps1` şu anda bir `-Verbose` anahtarı sunmuyor. Betik düzeyinde tanılama için PowerShell izlemeyi kullanın:

```powershell
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
```

Genellikle bir PATH sorunudur. Bkz. [Node.js sorun giderme](/tr/install/node#troubleshooting).

İlgili

• Kurulum genel bakışı
• Güncelleme
• Kaldırma