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
- install-cli.sh
- install.ps1
Kurulum başarılı olursa ancak yeni bir terminalde
openclaw bulunamazsa Node.js sorun giderme bölümüne bakın.install.sh
Akış (install.sh)
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
npmyöntemi (varsayılan): global npm kurulumugityöntemi: depoyu klonla/güncelle, bağımlılıkları pnpm ile kur, derle, ardından sarmalayıcıyı~/.local/bin/openclawkonumuna 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)
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
- Onboarding'i atla
- Git kurulumu
- GitHub main checkout
- Kuru çalıştırma
Bayraklar başvurusu
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
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
Her şeyi yerel bir prefix altında (varsayılan
~/.openclaw) tutmak ve sistem Node bağımlılığı istemediğiniz ortamlar için tasarlanmıştır. Varsayılan olarak npm kurulumlarını, ayrıca aynı prefix 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’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.OpenClaw'u prefix altında kur
npmyöntemi (varsayılan): npm ile prefix altına kurar, ardından sarmalayıcıyı<prefix>/bin/openclawkonumuna yazargityöntemi: bir checkout’u klonlar/günceller (varsayılan~/openclaw) ve sarmalayıcıyı yine<prefix>/bin/openclawkonumuna yazar
Örnekler (install-cli.sh)
- Varsayılan
- Özel prefix + sürüm
- Git kurulumu
- Otomasyon JSON çıktısı
- Onboarding çalıştır
Bayraklar başvurusu
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ı
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)
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
npmyöntemi (varsayılan): seçili-Tagkullanı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ırgityöntemi: repoyu klonlar/günceller, pnpm ile kurar/derler ve sarmalayıcıyı%USERPROFILE%\.local\bin\openclaw.cmdkonumuna kurar. Git eksikse betik,%LOCALAPPDATA%\OpenClaw\deps\portable-gitaltı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)
Örnekler (install.ps1)
- Varsayılan
- Git kurulumu
- GitHub main checkout
- Özel git dizini
- Kuru çalıştırma
- Hata ayıklama izi
Bayraklar referansı
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ı
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 |
-InstallMethod git kullanılırsa ve Git eksikse, betik Git for Windows bağlantısını yazdırmadan önce kullanıcıya yerel MinGit önyüklemesini 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 (onboarding'i atla)
Sorun giderme
Git neden gerekli?
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?
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"
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"
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
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:kurulumdan sonra openclaw bulunamıyor
kurulumdan sonra openclaw bulunamıyor
Genellikle bir PATH sorunudur. Bkz. Node.js sorun giderme.