Install overview

Yükleyici iç işleyişi

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

Betik	Platform	Yaptığı işlem
`install.sh`	macOS / Linux / WSL	Gerekiyorsa Node'u kurar, OpenClaw'ı npm (varsayılan) veya git aracılığıyla kurar ve ilk yapılandırmayı çalıştırabilir.
`install-cli.sh`	macOS / Linux / WSL	Node ve OpenClaw'ı npm veya git aracılığıyla yerel bir ön eke (`~/.openclaw`) kurar. Root yetkisi gerekmez.
`install.ps1`	Windows (PowerShell)	Gerekiyorsa Node'u kurar, OpenClaw'ı npm (varsayılan) veya git aracılığıyla kurar ve ilk yapılandırmayı çalıştırabilir.

Üçü de Node 22.19+, 23.11+ veya 24+ sürümlerini destekler; yeni kurulumlarda varsayılan hedef Node 24'tür.

Hızlı komutlar

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

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

install.ps1

powershell

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

powershell

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

install.sh

Akış (install.sh)

İşletim sistemini algıla

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

Varsayılan olarak Node.js 24'ü hazırla

Node sürümünü denetler ve gerekirse Node 24'ü kurar (macOS'te Homebrew, Linux'ta apt/dnf/yum için NodeSource kurulum betikleri). macOS'te Homebrew yalnızca kurulum betiği Node veya Git için buna ihtiyaç duyduğunda kurulur. Uyumluluk amacıyla Node 22.19+ ve 23.11+ desteklenmeye devam eder. Alpine/musl Linux'ta kurulum betiği NodeSource yerine apk paketlerini kullanır; yapılandırılmış Alpine depoları desteklenen bir Node sürümü sağlamalıdır (bu metnin yazıldığı sırada Alpine 3.21 veya daha yenisi).

Git'i hazırla

Git yoksa algılanan paket yöneticisini kullanarak kurar; buna macOS'te Homebrew ve Alpine'da apk dahildir.

OpenClaw'ı kur

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

Kurulum sonrası görevler

Sonraki komutlar için yeni kurulmuş openclaw ikili dosyasını çözümler
Yapılandırılmamış bir kurulumda, doctor veya gateway yoklamalarından önce ilk yapılandırmayı başlatır. --no-onboard kullanıldığında veya TTY olmadığında, kurulumu daha sonra tamamlamak için gereken komutu yazdırır.
Yapılandırılmış bir kurulumda, yüklenmiş 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 terminal arayüzü olmayan ancak istemlerin etkin olduğu bir çalıştırmada manuel komutu yazdırır.
--verify çalıştırıldığında, yalnızca yapılandırma mevcutsa kurulu sürümü ve Gateway durumunu denetler.

Kaynak çalışma kopyasını algılama

Bir OpenClaw çalışma kopyası (package.json + pnpm-workspace.yaml) içinde çalıştırılırsa betik şu seçenekleri sunar:

çalışma kopyasını kullan (git) veya
genel kurulumu kullan (npm)

TTY kullanılamıyorsa ve kurulum 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)

Varsayılan

bash

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

İlk yapılandırmayı atla

bash

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

Git kurulumu

bash

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

GitHub ana dal çalışma kopyası

bash

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

Deneme çalıştırması

bash

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

Kurulumdan sonra doğrula

bash

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

Bayraklar başvurusu

Bayrak	Açıklama
`--install-method \| --method npm\|git`	Kurulum 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, aksi hâlde `latest` değerine geri döner
`--git-dir \| --dir <path>`	Çalışma kopyası dizini (varsayılan: `~/openclaw`)
`--no-git-update`	Mevcut çalışma kopyası için `git pull` işlemini atlar
`--no-prompt`	İstemleri devre dışı bırakır
`--no-onboard`	İlk yapılandırmayı atlar
`--onboard`	İlk yapılandırmayı etkinleştirir
`--verify`	Kurulum sonrası hızlı doğrulama çalıştırır (`--version`, yüklüyse Gateway durumu)
`--dry-run`	Değişiklikleri uygulamadan işlemleri 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ı gösterir

Ortam değişkenleri başvurusu

Değişken	Açıklama
`OPENCLAW_INSTALL_METHOD=git\|npm`	Kurulum 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 yapılandırma yollarının temel dizini
`OPENCLAW_GIT_DIR=<path>`	Çalışma kopyası dizini
`OPENCLAW_GIT_UPDATE=0\|1`	Git güncellemelerini açar veya kapatır
`OPENCLAW_NO_PROMPT=1`	İstemleri devre dışı bırakır
`OPENCLAW_VERIFY_INSTALL=1`	Kurulum sonrası hızlı doğrulamayı çalıştırır
`OPENCLAW_NO_ONBOARD=1`	İlk yapılandırmayı 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

Akış (install-cli.sh)

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

Sabitlenmiş, desteklenen bir Node LTS tar arşivini (sürüm betiğe gömülüdür ve bağımsız olarak güncellenir; varsayılan 22.22.2) <prefix>/tools/node-v<version> konumuna indirir ve SHA-256 değerini doğrular. Node'un sabitlenmiş çalışma zamanı için uyumlu tar arşivleri yayımlamadığı Alpine/musl Linux'ta, nodejs ve npm paketlerini apk ile kurar ve bu çalışma zamanını ön ek sarmalayıcı yoluna bağlar. Alpine depoları desteklenen bir Node sürümü (22.19+, 23.11+ veya 24+) sağlamalıdır; eski depolar yalnızca Node 20 veya 21 sağlıyorsa Alpine 3.21 veya daha yenisini kullanın.

Git'i hazırla

Git yoksa Linux'ta apt/dnf/yum/apk veya macOS'te Homebrew aracılığıyla kurmayı dener.

OpenClaw'ı ön ek altına kur

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

Yüklenmiş Gateway hizmetini yenile

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

Örnekler (install-cli.sh)

Varsayılan

bash

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

Özel ön ek + sürüm

bash

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

Git kurulumu

bash

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

Otomasyon için JSON çıktısı

bash

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

İlk yapılandırmayı çalıştır

bash

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

Bayraklar başvurusu

Bayrak	Açıklama
`--prefix <path>`	Kurulum öneki (varsayılan: `~/.openclaw`)
`--install-method \| --method npm\|git`	Kurulum yöntemini seçer (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: `22.22.2`)
`--json`	NDJSON olayları üretir
`--onboard`	Kurulumdan sonra `openclaw onboard` komutunu çalıştırır
`--no-onboard`	İlk yapılandırmayı atlar (varsayılan)
`--set-npm-prefix`	Linux'ta mevcut önek yazılabilir değilse npm önekini `~/.npm-global` olarak ayarlar
`--help \| -h`	Kullanımı gösterir

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 yapılandırma 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çar veya kapatır
`OPENCLAW_NO_ONBOARD=1`	İlk yapılandırmayı atlar
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm günlük düzeyi (varsayılan: `error`)

install.ps1

Akış (install.ps1)

PowerShell ve Windows ortamını doğrulayın

PowerShell 5+ gerektirir.

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

Mevcut değilse sırasıyla winget, Chocolatey ve Scoop aracılığıyla kurmayı dener. Kullanılabilir bir paket yöneticisi yoksa betik, resmi Node.js 24 Windows zip dosyasını %LOCALAPPDATA%\OpenClaw\deps\portable-node konumuna indirir ve geçerli işlemin ve kullanıcının PATH değişkenine ekler. Uyumluluk için Node 22.19+ ve 23.11+ desteklenmeye devam eder.

OpenClaw'ı kurun

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 mevcut değilse betik, %LOCALAPPDATA%\OpenClaw\deps\portable-git altında kullanıcıya özel MinGit'i hazırlar ve geçerli işlemin ve kullanıcının PATH değişkenine ekler.

Kurulum sonrası görevleri çalıştırın

Gerektiğinde gerekli ikili dosya dizinini kullanıcının PATH değişkenine 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 komutunu çalıştırır (mümkün olan en iyi şekilde)

Hataları işleyin

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ı ise otomasyon için sıfır olmayan bir kodla çıkmaya devam eder.

Örnekler (install.ps1)

Varsayılan

powershell

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

Git kurulumu

powershell

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

GitHub main çalışma kopyası

powershell

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

Özel git dizini

powershell

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

Deneme çalıştırması

powershell

& ([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 tanımı (varsayılan: `latest`)
`-GitDir <path>`	Çalışma kopyası dizini (varsayılan: `%USERPROFILE%\openclaw`)
`-NoOnboard`	İlk yapılandırmayı atlar
`-NoGitUpdate`	`git pull` komutunu atlar
`-DryRun`	Yalnızca eylemleri yazdırı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 yapılandırmayı atlar
`OPENCLAW_GIT_UPDATE=0`	git pull'u devre dışı bırakır
`OPENCLAW_DRY_RUN=1`	Deneme çalıştırması modu

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)

bash

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

install.sh (etkileşimsiz git)

bash

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

install-cli.sh (JSON)

bash

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

install.ps1 (ilk yapılandırmayı atla)

powershell

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

Sorun giderme

Git neden gerekli?

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

npm neden Linux'ta EACCES hatası veriyor?

Bazı Linux yapılandırmaları, npm'in genel önekini root kullanıcısına 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 hazırlayabilmesi 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 komutunu çalıştırın ve bu dizini kullanıcınızın PATH değişkenine 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, bir -Verbose anahtarı sunmaz. 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))) -NoOnboardSet-PSDebug -Trace 0

Kurulumdan sonra openclaw bulunamıyor

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

İlgili

Was this useful?

Hızlı komutlar

install.sh

install-cli.sh

install.ps1

install.sh

Akış (install.sh)

İşletim sistemini algıla

Varsayılan olarak Node.js 24'ü hazırla

Git'i hazırla

OpenClaw'ı kur

Kurulum sonrası görevler

Kaynak çalışma kopyasını algılama

Örnekler (install.sh)

Varsayılan

İlk yapılandırmayı atla

Git kurulumu

GitHub ana dal çalışma kopyası

Deneme çalıştırması

Kurulumdan sonra doğrula

install-cli.sh

Akış (install-cli.sh)

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

Git'i hazırla

OpenClaw'ı ön ek altına kur

Yüklenmiş Gateway hizmetini yenile

Örnekler (install-cli.sh)

Varsayılan

Özel ön ek + sürüm

Git kurulumu

Otomasyon için JSON çıktısı

İlk yapılandırmayı çalıştır

install.ps1

Akış (install.ps1)

PowerShell ve Windows ortamını doğrulayın

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

OpenClaw'ı kurun

Kurulum sonrası görevleri çalıştırın

Hataları işleyin

Örnekler (install.ps1)

Varsayılan

Git kurulumu

GitHub main çalışma kopyası

Özel git dizini

Deneme çalıştırması

CI ve otomasyon

install.sh (etkileşimsiz npm)

install.sh (etkileşimsiz git)

install-cli.sh (JSON)

install.ps1 (ilk yapılandırmayı atla)

Sorun giderme

İlgili

On this page