OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

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

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

    Varsayılan

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

    İlk kurulumu atla

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

    Git yüklemesi

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

    GitHub ana dal kaynak kod çıkışı

    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

    Yüklemeden sonra doğrula

    bash
    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

    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

    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 yüklemesi

    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

    İlk kurulumu çalıştır

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

    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

    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"

    Kuru çalıştırma

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

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

    powershell
    & ([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:

    powershell
    Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0
    Kurulumdan sonra openclaw bulunamadı

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

    İlgili

    Was this useful?
    On this page

    On this page