Yükleyici iç işleyişi

OpenClaw, openclaw.ai üzerinden sunulan üç yükleyici betiğiyle birlikte gelir.

Betik	Platform	İşlevi
`install.sh`	macOS / Linux / WSL	Gerekirse Node’u yükler, OpenClaw’u npm (varsayılan) veya git aracılığıyla yükler, ilk kurulumu çalıştırabilir.
`install-cli.sh`	macOS / Linux / WSL	Node + OpenClaw’u npm veya git aracılığıyla yerel bir ön eke (`~/.openclaw`) yükler. Root yetkisi gerekmez.
`install.ps1`	Windows (PowerShell)	Gerekirse Node’u yükler, OpenClaw’u npm (varsayılan) veya git aracılığıyla yükler, ilk kurulumu çalıştırabilir.

Üçü de Node 22.22.3+, 24.15+ veya 25.9+ sürümlerini destekler; yeni yüklemelerde varsayılan hedef Node 24’tür.

Hızlı komutlar

install.sh
install-cli.sh
install.ps1

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

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

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

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

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

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

Yükleme başarılı olduğu hâlde yeni bir terminalde openclaw bulunamıyorsa Node.js sorun giderme bölümüne bakın.

install.sh

macOS/Linux/WSL üzerindeki çoğu etkileşimli yükleme için önerilir.

Akış (install.sh)

İşletim sistemini algıla

macOS ve Linux’u (WSL dâhil) destekler.

Varsayılan olarak Node.js 24'ü sağla

Node sürümünü denetler ve gerekirse Node 24’ü yükler (macOS’te Homebrew, Linux’ta apt/dnf/yum için NodeSource kurulum betikleri). macOS’te Homebrew yalnızca yükleyicinin Node veya Git için buna ihtiyaç duyması durumunda yüklenir. Node 22.22.3+, Node 24.15+ ve Node 25.9+ desteklenir; Node 23 desteklenmez. Alpine/musl Linux’ta yükleyici, NodeSource yerine apk paketlerini kullanır ve gerçekten bağlanan SQLite sürümünü doğrular. Güncel kararlı Alpine paket akışları, güvenlik açığı bulunan sistem SQLite’ı ile birlikte yeterince yeni bir Node sağlayabilir; bu durumda bunun yerine resmî bir node:24-alpine konteyneri veya glibc tabanlı bir ana makine kullanın.

Git'i sağla

Git yoksa macOS’te Homebrew ve Alpine’da apk dâhil olmak üzere algılanan paket yöneticisini kullanarak yükler.

OpenClaw'u yükle

npm yöntemi (varsayılan): genel npm yüklemesi
git yöntemi: depoyu klonlar/günceller, bağımlılıkları pnpm ile yükler, derler ve ardından sarmalayıcıyı ~/.local/bin/openclaw konumuna yükler

Yükleme sonrası görevler

Sonraki komutlar için yeni yüklenen openclaw ikili dosyasını çözümler
Yapılandırılmamış bir yüklemede doctor veya gateway yoklamalarından önce ilk kurulumu başlatır. --no-onboard kullanıldığında veya TTY bulunmadığında, kurulumu daha sonra tamamlamak için gereken komutu yazdırır.
Yapılandırılmış bir yüklemede, yüklenmiş bir gateway hizmetini mümkün olan en iyi şekilde yenileyip yeniden başlatır ve doctor’ı çalıştırır. Yükseltmeler mümkün olduğunda plugin’leri günceller veya istemlerin etkin olduğu başsız bir çalıştırmada manuel komutu yazdırır.
--verify çalıştırıldığında, yüklü sürümü denetler ve gateway durumunu yalnızca yapılandırma mevcutsa denetler.

Kaynak kod çıkışını algılama

Betik bir OpenClaw kaynak kod çıkışının (package.json + pnpm-workspace.yaml) içinde çalıştırılırsa şu seçenekleri sunar:

kaynak kod çıkışını kullan (git) veya
genel yüklemeyi kullan (npm)

TTY bulunmuyorsa ve herhangi bir yükleme yöntemi ayarlanmamışsa varsayılan olarak npm kullanılır ve bir uyarı gösterilir. Betik, geçersiz yöntem seçimi veya geçersiz --install-method değerleri için 2 koduyla çıkar.

Örnekler (install.sh)

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

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

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

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

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard --verify

Bayrak başvurusu

Bayrak	Açıklama
`--install-method \| --method npm\|git`	Yükleme yöntemini seçer (varsayılan: `npm`)
`--npm`	npm yöntemi için kısayol
`--git \| --github`	git yöntemi için kısayol
`--version <version\|dist-tag\|spec>`	npm sürümü, dağıtım etiketi veya paket belirtimi (varsayılan: `latest`)
`--beta`	Varsa beta dağıtım etiketini kullanır, yoksa `latest` sürümüne geri döner
`--git-dir \| --dir <path>`	Kaynak kod çıkışı dizini (varsayılan: `~/openclaw`)
`--no-git-update`	Mevcut kaynak kod çıkışı için `git pull` işlemini atlar
`--no-prompt`	İstemleri devre dışı bırakır
`--no-onboard`	İlk kurulumu atlar
`--onboard`	İlk kurulumu etkinleştirir
`--verify`	Yükleme sonrası hızlı doğrulama çalıştırır (`--version`, yüklüyse gateway durumu)
`--dry-run`	Değişiklikleri uygulamadan eylemleri yazdırır
`--verbose`	Hata ayıklama çıktısını etkinleştirir (`set -x`, npm bildirim düzeyi günlükleri)
`--help \| -h`	Kullanım bilgisini gösterir

Ortam değişkenleri başvurusu

Değişken	Açıklama
`OPENCLAW_INSTALL_METHOD=git\|npm`	Yükleme yöntemi
`OPENCLAW_VERSION=latest\|next\|<semver>\|<spec>`	npm sürümü, dağıtım etiketi veya paket belirtimi
`OPENCLAW_BETA=0\|1`	Varsa beta sürümünü kullanır
`OPENCLAW_HOME=<path>`	OpenClaw durumu ile varsayılan git/ilk kurulum yollarının temel dizini
`OPENCLAW_GIT_DIR=<path>`	Kaynak kod çıkışı dizini
`OPENCLAW_GIT_UPDATE=0\|1`	git güncellemelerini açar/kapatır
`OPENCLAW_NO_PROMPT=1`	İstemleri devre dışı bırakır
`OPENCLAW_VERIFY_INSTALL=1`	Yükleme sonrası hızlı doğrulamayı çalıştırır
`OPENCLAW_NO_ONBOARD=1`	İlk kurulumu atlar
`OPENCLAW_DRY_RUN=1`	Deneme çalıştırması modu
`OPENCLAW_VERBOSE=1`	Hata ayıklama modu
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm günlük düzeyi (varsayılan: `error`, npm kullanımdan kaldırma gürültüsünü gizler)

install-cli.sh

Her şeyin yerel bir ön ek altında (varsayılan ~/.openclaw) bulunmasını ve sistem Node bağımlılığı olmamasını istediğiniz ortamlar için tasarlanmıştır. Varsayılan olarak npm yüklemelerini ve aynı ön ek akışı altında git kaynak kod çıkışı yüklemelerini destekler.

Akış (install-cli.sh)

Yerel Node çalışma zamanını yükle

Sabitlenmiş ve desteklenen bir Node LTS tarball’ını (sürüm betiğe gömülüdür ve bağımsız olarak güncellenir, varsayılan 24.15.0) <prefix>/tools/node-v<version> konumuna indirir ve SHA-256’yı doğrular. Resmî Node 24+ ARMv7 ikili dosyaları bulunmadığından Linux ARMv7, Node 22.22.3 kullanır. Node’un sabitlenmiş çalışma zamanı için uyumlu tarball’lar yayımlamadığı Alpine/musl Linux’ta nodejs ve npm paketlerini apk ile yükler, ardından hem Node’u hem de gerçekten bağlanan SQLite kitaplığını doğrular. Güncel kararlı Alpine paket akışları, yeterince yeni bir Node ile bile güvenlik açığı bulunan SQLite’a bağlanabilir; güvenlik denetimi paketi reddettiğinde resmî bir node:24-alpine konteyneri veya glibc tabanlı bir ana makine kullanın.

Git'i sağla

Git yoksa Linux’ta apt/dnf/yum/apk veya macOS’te Homebrew aracılığıyla yüklemeyi dener.

OpenClaw'u ön ek altına yükle

npm yöntemi (varsayılan): npm ile ön ek altına yükler, ardından sarmalayıcıyı <prefix>/bin/openclaw konumuna yazar
git yöntemi: bir kaynak kod çıkışını (varsayılan ~/openclaw) klonlar/günceller ve yine sarmalayıcıyı <prefix>/bin/openclaw konumuna yazar

Yüklü gateway hizmetini yenile

Aynı ön ekten bir gateway hizmeti zaten yüklenmişse betik, yerine geçen hizmeti etkinleştiren openclaw gateway install --force komutunu çalıştırır ve ardından gateway durumunu mümkün olan en iyi şekilde yoklar.

Örnekler (install-cli.sh)

Varsayılan
Özel ön ek + sürüm
Git yüklemesi
Otomasyon JSON çıktısı
İlk kurulumu çalıştır

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw

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

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

Bayrak başvurusu

Bayrak	Açıklama
`--prefix <path>`	Kurulum öneki (varsayılan: `~/.openclaw`)
`--install-method \| --method npm\|git`	Kurulum yöntemini seçin (varsayılan: `npm`)
`--npm`	npm yöntemi için kısayol
`--git \| --github`	git yöntemi için kısayol
`--git-dir \| --dir <path>`	Git çalışma kopyası dizini (varsayılan: `~/openclaw`)
`--version <ver>`	OpenClaw sürümü veya dağıtım etiketi (varsayılan: `latest`)
`--node-version <ver>`	Node sürümü (varsayılan: `24.15.0`; Linux ARMv7’de `22.22.3`)
`--json`	NDJSON olayları yayınla
`--onboard`	Kurulumdan sonra `openclaw onboard` çalıştır
`--no-onboard`	İlk kurulumu atla (varsayılan)
`--set-npm-prefix`	Linux’ta geçerli önek yazılabilir değilse npm önekini `~/.npm-global` olarak zorla
`--help \| -h`	Kullanımı göster

Ortam değişkenleri referansı

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 dağıtım etiketi
`OPENCLAW_NODE_VERSION=<ver>`	Node sürümü
`OPENCLAW_HOME=<path>`	OpenClaw durumu ve varsayılan git/ilk kurulum yolları için temel dizin
`OPENCLAW_GIT_DIR=<path>`	git kurulumları için Git çalışma kopyası dizini
`OPENCLAW_GIT_UPDATE=0\|1`	Mevcut çalışma kopyaları için git güncellemelerini aç/kapat
`OPENCLAW_NO_ONBOARD=1`	İlk kurulumu atla
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm günlük düzeyi (varsayılan: `error`)

openclaw@main ve diğer GitHub kaynak belirtimleri, npm kurulumlarında geçerli --version hedefleri değildir. Bunun yerine --install-method git --version main kullanın.

install.ps1

Akış (install.ps1)

PowerShell + Windows ortamını sağlama

PowerShell 5+ gerektirir.

Varsayılan olarak Node.js 24'ü sağlama

Eksikse önce winget, ardından Chocolatey, sonra Scoop aracılığıyla kurmayı dener. Kullanılabilir paket yöneticisi yoksa betik, resmi Node.js 24 Windows zip dosyasını %LOCALAPPDATA%\OpenClaw\deps\portable-node içine indirir ve geçerli işlemin ve kullanıcının PATH’ine ekler. Node 22.22.3+, Node 24.15+ ve Node 25.9+ desteklenir; Node 23 desteklenmez.

OpenClaw'ı kurma

npm yöntemi (varsayılan): seçilen -Tag kullanılarak genel npm kurulumu; C:\ gibi korumalı klasörlerde açılan kabukların da çalışabilmesi için yazılabilir bir geçici yükleyici dizininden başlatılır
git yöntemi: depoyu klonlar/günceller, pnpm ile kurar/derler ve sarmalayıcıyı %USERPROFILE%\.local\bin\openclaw.cmd konumuna kurar. Git eksikse betik, kullanıcıya özel MinGit’i %LOCALAPPDATA%\OpenClaw\deps\portable-git altında önyükler ve geçerli işlemin ve kullanıcının PATH’ine ekler.

Kurulum sonrası görevler

Gerektiğinde gerekli ikili dosya dizinini kullanıcı PATH’ine ekler
Yüklü bir Gateway hizmetini mümkün olan en iyi şekilde yeniler (önce openclaw gateway install --force, ardından yeniden başlatma)
Yükseltmelerde ve git kurulumlarında openclaw doctor --non-interactive çalıştırır (mümkün olan en iyi şekilde)

Hataları işleme

iwr ... | iex ve betik bloğu kurulumları, geçerli PowerShell oturumunu kapatmadan sonlandırıcı bir hata bildirir. Doğrudan powershell -File / pwsh -File kurulumları, otomasyon için yine sıfırdan farklı bir kodla çıkar.

Örnekler (install.ps1)

Varsayılan
Git kurulumu
GitHub main çalışma kopyası
Özel git dizini
Kuru çalıştırma

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag main

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun

Bayraklar referansı

Bayrak	Açıklama
`-InstallMethod npm\|git`	Kurulum yöntemi (varsayılan: `npm`)
`-Tag <tag\|version\|spec>`	npm dağıtım etiketi, sürümü veya paket belirtimi (varsayılan: `latest`)
`-GitDir <path>`	Çalışma kopyası dizini (varsayılan: `%USERPROFILE%\openclaw`)
`-NoOnboard`	İlk kurulumu atla
`-NoGitUpdate`	`git pull` atla
`-DryRun`	Yalnızca eylemleri yazdır

Ortam değişkenleri referansı

Değişken	Açıklama
`OPENCLAW_INSTALL_METHOD=git\|npm`	Kurulum yöntemi
`OPENCLAW_GIT_DIR=<path>`	Çalışma kopyası dizini
`OPENCLAW_NO_ONBOARD=1`	İlk kurulumu atla
`OPENCLAW_GIT_UPDATE=0`	git pull’u devre dışı bırak
`OPENCLAW_DRY_RUN=1`	Kuru çalıştırma modu

-InstallMethod git kullanılır ve Git eksikse betik, Git for Windows bağlantısını yazdırmadan önce kullanıcıya özel bir MinGit önyüklemesi dener.

CI ve otomasyon

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

install.sh (etkileşimsiz npm)
install.sh (etkileşimsiz git)
install-cli.sh (JSON)
install.ps1 (ilk kurulumu atla)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Sorun giderme

Git neden gereklidir?

Git, git kurulum yöntemi için gereklidir. npm kurulumlarında da bağımlılıklar git URL’leri kullandığında oluşabilecek spawn git ENOENT hatalarını önlemek için Git denetlenir/kurulur.

npm neden Linux'ta EACCES hatası veriyor?

Bazı Linux kurulumları npm’in genel önekini root’a ait yollara yönlendirir. install.sh, öneki ~/.npm-global olarak değiştirebilir ve kabuk rc dosyalarına PATH dışa aktarımlarını ekleyebilir (bu dosyalar mevcutsa).

Windows: "npm error spawn git / ENOENT"

Kullanıcıya özel MinGit’i önyükleyebilmesi için yükleyiciyi yeniden çalıştırın veya Git for Windows’u kurup PowerShell’i yeniden açın.

Windows: "openclaw is not recognized"

npm config get prefix çalıştırın ve bu dizini kullanıcı PATH’inize ekleyin (Windows’ta \bin soneki gerekmez), ardından PowerShell’i yeniden açın.

Windows: ayrıntılı yükleyici çıktısı nasıl alınır

install.ps1, bir -Verbose anahtarı sunmaz. Betik düzeyinde tanılama için PowerShell izlemeyi kullanın:

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

Kurulumdan sonra openclaw bulunamadı

Bu genellikle bir PATH sorunudur. Bkz. Node.js sorun giderme.

Install overview

Maintenance

Containers

Hosting

Advanced setup

Yükleyici iç işleyişi

Hızlı komutlar

install.sh

Akış (install.sh)

Kaynak kod çıkışını algılama

Örnekler (install.sh)

install-cli.sh

Akış (install-cli.sh)

Örnekler (install-cli.sh)

install.ps1

Akış (install.ps1)

Örnekler (install.ps1)

CI ve otomasyon

Sorun giderme

İlgili

​Hızlı komutlar

​install.sh

​Akış (install.sh)

​Kaynak kod çıkışını algılama

​Örnekler (install.sh)

​install-cli.sh

​Akış (install-cli.sh)

​Örnekler (install-cli.sh)

​install.ps1

​Akış (install.ps1)

​Örnekler (install.ps1)

​CI ve otomasyon

​Sorun giderme

​İlgili

Hızlı komutlar

install.sh

Akış (install.sh)

Kaynak kod çıkışını algılama

Örnekler (install.sh)

install-cli.sh

Akış (install-cli.sh)

Örnekler (install-cli.sh)

install.ps1

Akış (install.ps1)

Örnekler (install.ps1)

CI ve otomasyon

Sorun giderme

İlgili