Install overview

Yükleyicinin iç işleyişi

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

Betik	Platform	Ne yapar
`install.sh`	macOS / Linux / WSL	Gerekirse Node kurar, OpenClaw'u npm (varsayılan) veya git üzerinden kurar ve onboarding çalıştırabilir.
`install-cli.sh`	macOS / Linux / WSL	Node + OpenClaw'u npm veya git checkout modlarıyla yerel bir prefix içine (`~/.openclaw`) kurar. Root gerekmez.
`install.ps1`	Windows (PowerShell)	Gerekirse Node kurar, OpenClaw'u npm (varsayılan) veya git üzerinden kurar ve onboarding çalıştırabilir.

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 dahil) destekler.

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). macOS'ta Homebrew yalnızca yükleyicinin Node veya Git için ihtiyacı olduğunda kurulur. OpenClaw, uyumluluk için şu anda 22.19+ olan Node 22 LTS'yi desteklemeye devam eder. Alpine/musl Linux'ta yükleyici NodeSource yerine apk paketlerini kullanır; yapılandırılmış Alpine depoları Node 22.19+ sağlamalıdır (bu yazının yazıldığı sırada Alpine 3.21 veya daha yeni).

Git'i sağla

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

OpenClaw'u kur

npm yöntemi (varsayılan): global npm kurulumu
git yöntemi: depoyu klonla/güncelle, bağımlılıkları pnpm ile kur, derle, ardından sarmalayıcıyı ~/.local/bin/openclaw konumuna kur

Kurulum sonrası görevler

Yüklü bir gateway servisini en iyi çabayla yeniler (openclaw gateway install --force, ardından yeniden başlatma)
Yükseltmelerde ve git kurulumlarında openclaw doctor --non-interactive çalıştırır (en iyi çaba)
Uygun olduğunda onboarding yapmayı dener (TTY kullanılabilir, onboarding devre dışı değil ve bootstrap/config denetimleri geçiyor)

Kaynak checkout algılama

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

checkout kullan (git), veya
global kurulumu kullan (npm)

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

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

Onboarding'i 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 main checkout

bash

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

Kuru çalıştırma

bash

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

Bayraklar başvurusu

Bayrak	Açıklama
`--install-method npm\|git`	Kurulum yöntemini seç (varsayılan: `npm`). Alias: `--method`
`--npm`	npm yöntemi için kısayol
`--git`	git yöntemi için kısayol. Alias: `--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`'e geri dön
`--git-dir <path>`	Checkout dizini (varsayılan: `~/openclaw`). Alias: `--dir`
`--no-git-update`	Mevcut checkout için `git pull` işlemini atla
`--no-prompt`	Promptları 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-level günlükleri)
`--help`	Kullanımı göster (`-h`)

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ü, dist-tag veya paket spec'i
`OPENCLAW_BETA=0\|1`	Varsa beta kullan
`OPENCLAW_HOME=<path>`	OpenClaw durumu ve varsayılan git/onboarding yolları için temel dizin
`OPENCLAW_GIT_DIR=<path>`	Checkout dizini
`OPENCLAW_GIT_UPDATE=0\|1`	git güncellemelerini aç/kapat
`OPENCLAW_NO_PROMPT=1`	Promptları devre dışı bırak
`OPENCLAW_NO_ONBOARD=1`	Onboarding'i atla
`OPENCLAW_DRY_RUN=1`	Kuru çalıştırma modu
`OPENCLAW_VERBOSE=1`	Hata ayıklama modu
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm günlük düzeyi

install-cli.sh

Akış (install-cli.sh)

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

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

Git'i sağla

Git eksikse Linux'ta apt/dnf/yum/apk veya macOS'ta Homebrew üzerinden kurmayı dener.

OpenClaw'u prefix altında kur

npm yöntemi (varsayılan): npm ile prefix altına kurar, ardından sarmalayıcıyı <prefix>/bin/openclaw konumuna yazar
git yöntemi: bir checkout'u klonlar/günceller (varsayılan ~/openclaw) ve sarmalayıcıyı yine <prefix>/bin/openclaw konumuna yazar

Yüklü gateway servisini yenile

Bir gateway servisi aynı prefix'ten zaten yüklüyse betik openclaw gateway install --force, ardından openclaw gateway restart çalıştırır ve gateway sağlığını en iyi çabayla yoklar.

Örnekler (install-cli.sh)

Varsayılan

bash

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

Özel prefix + 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 JSON çıktısı

bash

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

Onboarding ç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 npm\|git`	Kurulum yöntemini seçer (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ır
`--no-onboard`	Onboarding'i atlar (varsayılan)
`--set-npm-prefix`	Linux'ta, geçerli önek yazılabilir değilse npm önekini `~/.npm-global` yapmaya zorlar
`--help`	Kullanımı gösterir (`-h`)

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 dist-tag
`OPENCLAW_NODE_VERSION=<ver>`	Node sürümü
`OPENCLAW_HOME=<path>`	OpenClaw durumu ve varsayılan git/onboarding yolları için temel dizin
`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çıp kapatır
`OPENCLAW_NO_ONBOARD=1`	Onboarding'i atlar
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm günlük düzeyi

install.ps1

Akış (install.ps1)

PowerShell + Windows ortamını doğrula

PowerShell 5+ gerektirir.

Varsayılan olarak Node.js 24'ü doğrula

Eksikse, önce winget, sonra Chocolatey, sonra Scoop üzerinden kurmayı dener. Hiçbir paket yöneticisi yoksa betik resmi Node.js Windows zip dosyasını %LOCALAPPDATA%\OpenClaw\deps\portable-node içine indirir ve geçerli işleme ve kullanıcı PATH'ine ekler. Node 22 LTS, şu anda 22.19+, uyumluluk için desteklenmeye devam eder.

OpenClaw'u kur

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

Kurulum sonrası görevler

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

Hataları işle

iwr ... | iex ve scriptblock kurulumları, geçerli PowerShell oturumunu kapatmadan sonlandırıcı bir hata bildirir. Doğrudan powershell -File / pwsh -File kurulumları otomasyon için yine de sıfır olmayan çıkış koduyla çıkar.

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

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"

Kuru çalıştırma

powershell

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

Hata ayıklama izi

powershell

# install.ps1 has no dedicated -Verbose flag yet.Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0

Bayraklar referansı

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 atlar
`-NoGitUpdate`	`git pull` işlemini 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>`	Checkout dizini
`OPENCLAW_NO_ONBOARD=1`	Onboarding'i atlar
`OPENCLAW_GIT_UPDATE=0`	git pull'u devre dışı bırakır
`OPENCLAW_DRY_RUN=1`	Kuru çalıştırma 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 (onboarding'i atla)

powershell

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

Sorun giderme

Git neden gerekli?

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

Linux'ta npm neden EACCES ile karşılaşıyor?

Bazı Linux kurulumları npm global önekini root'a ait yollara 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 mevcut olduğunda).

Windows: "npm error spawn git / ENOENT"

Kullanıcıya yerel MinGit'i önyükleyebilmesi için kurulum aracını 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ı PATH'inize ekleyin (Windows'ta \bin son eki gerekmez), ardından PowerShell'i yeniden açın.

Windows: ayrıntılı kurulum çıktısı nasıl alınır

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

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'ü sağla

Git'i sağla

OpenClaw'u kur

Kurulum sonrası görevler

Kaynak checkout algılama

Örnekler (install.sh)

Varsayılan

Onboarding'i atla

Git kurulumu

GitHub main checkout

Kuru çalıştırma

install-cli.sh

Akış (install-cli.sh)

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

Git'i sağla

OpenClaw'u prefix altında kur

Yüklü gateway servisini yenile

Örnekler (install-cli.sh)

Varsayılan

Özel prefix + sürüm

Git kurulumu

Otomasyon JSON çıktısı

Onboarding çalıştır

install.ps1

Akış (install.ps1)

PowerShell + Windows ortamını doğrula

Varsayılan olarak Node.js 24'ü doğrula

OpenClaw'u kur

Kurulum sonrası görevler

Hataları işle

Örnekler (install.ps1)

Varsayılan

Git kurulumu

GitHub main checkout

Özel git dizini

Kuru çalıştırma

Hata ayıklama izi

CI ve otomasyon

install.sh (etkileşimsiz npm)

install.sh (etkileşimsiz git)

install-cli.sh (JSON)

install.ps1 (onboarding'i atla)

Sorun giderme

İlgili

On this page