Yükle

Sistem gereksinimleri

• Node 22.19+, 23.11+ veya 24+ - Varsayılan hedef Node 24'tür; yükleyici betiği bunu otomatik olarak yönetir.
• macOS, Linux veya Windows - Windows kullanıcıları yerel Windows Hub uygulamasıyla, PowerShell CLI yükleyicisiyle veya bir WSL2 Gateway ile başlayabilir. Bkz. Windows.
• pnpm yalnızca kaynaktan derleme yapıyorsanız gereklidir.

Önerilen: yükleyici betiği

En hızlı yükleme yöntemidir. İşletim sisteminizi algılar, gerekirse Node'u yükler, OpenClaw'u yükler ve ilk kurulumu başlatır.

curl -fsSL https://openclaw.ai/install.sh | bash

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

İlk kurulumu çalıştırmadan yüklemek için:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

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

Tüm bayraklar ve CI/otomasyon seçenekleri için Yükleyicinin iç işleyişi bölümüne bakın.

Alternatif yükleme yöntemleri

Yerel önek yükleyicisi (install-cli.sh)

OpenClaw ve Node'u sistem genelindeki bir Node kurulumuna bağlı olmadan ~/.openclaw gibi yerel bir önek altında tutmak istediğinizde bunu kullanın:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

Varsayılan olarak npm yüklemelerini ve aynı önek akışı altında git çalışma kopyası yüklemelerini destekler. Tam başvuru: Yükleyicinin iç işleyişi.

Zaten yüklü mü? openclaw update --channel dev ve openclaw update --channel stable komutlarıyla paket ve git yüklemeleri arasında geçiş yapın. Bkz. Güncelleme.

npm, pnpm veya bun

Node'u zaten kendiniz yönetiyorsanız:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Kaynaktan

Katkıda bulunanlar veya yerel bir çalışma kopyasından çalıştırmak isteyenler için:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Alternatif olarak bağlantı adımını atlayıp depo içinden pnpm openclaw ... komutunu kullanabilirsiniz. Tüm geliştirme iş akışları için Kurulum bölümüne bakın.

GitHub ana dal çalışma kopyasından yükleme

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

Kapsayıcılar ve paket yöneticileri

Yüklemeyi doğrulama

openclaw --version      # CLI'ın kullanılabilir olduğunu doğrulayınopenclaw doctor         # yapılandırma sorunlarını denetleyinopenclaw gateway status # Gateway'in çalıştığını doğrulayın

Yüklemeden sonra yönetilen başlangıç istiyorsanız:

• macOS: openclaw onboard --install-daemon veya openclaw gateway install aracılığıyla LaunchAgent
• Linux/WSL2: aynı komutlar aracılığıyla systemd kullanıcı hizmeti
• Yerel Windows: Önce Scheduled Task; görev oluşturma reddedilirse kullanıcı başına Startup klasörü oturum açma öğesi yedeği

Barındırma ve dağıtım

OpenClaw'u bir bulut sunucusuna veya VPS'ye dağıtın. Sağlayıcıların tam listesi (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi ve diğerleri) için Linux sunucusu bölümüne bakın veya Render üzerinde bildirimsel olarak dağıtın.

Güncelleme, taşıma veya kaldırma

Sorun giderme: openclaw bulunamadı

Bu neredeyse her zaman bir PATH sorunudur: npm'in genel ikili dosya dizini kabuğunuzun PATH değişkeninde değildir. Windows yolu dâhil tam çözüm için Node.js sorun giderme bölümüne bakın.

node -v           # Node yüklü mü?npm prefix -g     # Genel paketler nerede?echo "$PATH"      # Genel ikili dosya dizini PATH içinde mi?