Yükleyici iç yapısı

OpenClaw, openclaw.ai üzerinden sunulan üç yükleyici betiğiyle 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 öneke (`~/.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

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

Kurulum başarılı olduğu hâlde yeni bir terminalde openclaw bulunamıyorsa bkz. Node.js troubleshooting.

install.sh

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

Akış (install.sh)

İşletim sistemini algıla

macOS ve Linux’u (WSL dahil) destekler. macOS algılanırsa Homebrew eksikse kurar.

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

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 şu anda 22.14+ olan Node 22 LTS sürümünü de desteklemeye devam eder.

Git'i sağla

Git eksikse kurar.

OpenClaw'ı kur

npm yöntemi (varsayılan): global npm kurulumu
git yöntemi: depoyu clone eder/günceller, bağımlılıkları pnpm ile kurar, derler, ardından sarmalayıcıyı ~/.local/bin/openclaw konumuna kurar

Kurulum sonrası görevler

Yüklenmiş bir gateway hizmetini en iyi çabayla yeniler (openclaw gateway install --force, sonra yeniden başlatır)
Yükseltmelerde ve git kurulumlarında en iyi çabayla openclaw doctor --non-interactive çalıştırır
Uygun olduğunda onboarding denemesi yapar (TTY mevcutsa, onboarding devre dışı değilse 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
global kurulumu kullan (npm)

TTY yoksa ve 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)

Varsayılan
Onboarding'i atla
Git kurulumu
npm üzerinden GitHub main
Dry run

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 -- --version main

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

Bayrak başvurusu

Bayrak	Açıklama
`--install-method npm\|git`	Kurulum yöntemini seçin (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 belirtimi (varsayılan: `latest`)
`--beta`	Varsa beta dist-tag kullan, yoksa `latest` değerine geri dön
`--git-dir <path>`	Checkout dizini (varsayılan: `~/openclaw`). Takma ad: `--dir`
`--no-git-update`	Mevcut checkout için `git pull` komutunu atla
`--no-prompt`	İstemleri devre dışı bırak
`--no-onboard`	Onboarding’i atla
`--onboard`	Onboarding’i etkinleştir
`--dry-run`	Değişiklikleri 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`)

Ortam değişkeni başvurusu

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 belirtimi
`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 istediğiniz (varsayılan ~/.openclaw) ve sistem Node bağımlılığı istemediğ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)

Yerel Node çalışma zamanını kur

Sabitlenmiş desteklenen bir Node LTS tarball sürümünü (<prefix>/tools/node-v<version> konumuna) indirir (sürüm betiğin içine gömülüdür ve bağımsız güncellenir) ve SHA-256 doğrular.

Git'i sağla

Git eksikse Linux’ta apt/dnf/yum veya macOS’ta Homebrew üzerinden kurmaya çalışır.

OpenClaw'ı önek altında kur

npm yöntemi (varsayılan): önek altında npm ile kurar, sonra sarmalayıcıyı <prefix>/bin/openclaw konumuna yazar
git yöntemi: checkout’u clone eder/günceller (varsayılan ~/openclaw) ve yine sarmalayıcıyı <prefix>/bin/openclaw konumuna yazar

Yüklenmiş gateway hizmetini yenile

Aynı önekten yüklenmiş bir gateway hizmeti zaten varsa betik openclaw gateway install --force, ardından openclaw gateway restart çalıştırır ve gateway sağlığını en iyi çabayla probe eder.

Örnekler (install-cli.sh)

Varsayılan
Özel önek + sürüm
Git kurulumu
Otomasyon JSON çıktısı
Onboarding'i ç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 npm\|git`	Kurulum yöntemini seçin (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ı üretir
`--onboard`	Kurulumdan sonra `openclaw onboard` çalıştırır
`--no-onboard`	Onboarding’i atla (varsayılan)
`--set-npm-prefix`	Linux’ta, mevcut önek yazılabilir değilse npm önekini `~/.npm-global` olarak zorlar
`--help`	Kullanımı göster (`-h`)

Ortam değişkeni başvurusu

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 Git 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 + Windows ortamını sağla

PowerShell 5+ gerektirir.

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

Eksikse sırasıyla winget, sonra Chocolatey, sonra Scoop üzerinden kurmaya çalışır. Şu anda 22.14+ olan Node 22 LTS, uyumluluk için desteklenmeye devam eder.

OpenClaw'ı kur

npm yöntemi (varsayılan): seçilen -Tag kullanılarak global npm kurulumu
git yöntemi: depoyu clone eder/günceller, pnpm ile kurar/derler ve sarmalayıcıyı %USERPROFILE%\.local\bin\openclaw.cmd konumuna kurar

Kurulum sonrası görevler

Mümkün olduğunda gerekli bin dizinini kullanıcı PATH’ine ekler
Yüklenmiş bir gateway hizmetini en iyi çabayla yeniler (openclaw gateway install --force, sonra yeniden başlatır)
Yükseltmelerde ve git kurulumlarında en iyi çabayla openclaw doctor --non-interactive çalıştırır

Örnekler (install.ps1)

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))) -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

# 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 başvurusu

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

Ortam değişkeni başvurusu

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ır 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/env değişkenleri kullanın.

install.sh (etkileşimsiz npm)
install.sh (etkileşimsiz git)
install-cli.sh (JSON)
install.ps1 (onboarding'i 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 gerekiyor?

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

npm neden Linux'ta EACCES alıyor?

Bazı Linux kurulumları npm global önekini root’a ait yollara yönlendirir. install.sh, öneki ~/.npm-global değerine çevirebilir ve PATH dışa aktarımlarını shell rc dosyalarına ekleyebilir (bu dosyalar varsa).

sharp/libvips sorunları

Betikler, sharp’ın sistem libvips’e karşı derlenmesini önlemek için varsayılan olarak SHARP_IGNORE_GLOBAL_LIBVIPS=1 ayarlar. Geçersiz kılmak için:

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

Windows: "npm error spawn git / ENOENT"

Git for Windows kurun, PowerShell’i yeniden açın, yükleyiciyi tekrar çalıştırı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 son eki gerekmez), ardından PowerShell’i yeniden açın.

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

install.ps1 şu anda bir -Verbose anahtarı sunmuyor. Betik düzeyi 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 bulunamıyor

Genellikle PATH sorunudur. Bkz. Node.js troubleshooting.

Install overview

Containers

Hosting

Maintenance

Yükleyici İç Yapısı

Yükleyici iç yapısı

Hızlı komutlar

install.sh

Akış (install.sh)

Kaynak checkout 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

Install overview

Containers

Hosting

Maintenance

​Yükleyici iç yapısı

​Hızlı komutlar

​install.sh

​Akış (install.sh)

​Kaynak checkout 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

Yükleyici iç yapısı

Hızlı komutlar

install.sh

Akış (install.sh)

Kaynak checkout 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