Yükle

Sistem gereksinimleri

• Node 22.22.3+, 24.15+ veya 25.9+ - Varsayılan hedef Node 24'tür; yükleyici betiği bunu otomatik olarak halleder.
• macOS, Linux veya Windows - Windows kullanıcıları yerel Windows Hub uygulaması, PowerShell CLI yükleyicisi veya 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ş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şleyişi.

Zaten yüklü mü? openclaw update --channel dev ve openclaw update --channel stable ile 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ı oluşturmayı atlayıp depo içinden pnpm openclaw ... kullanın. Eksiksiz 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'nin 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şlatma 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ıya özel 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. Eksiksiz sağlayıcı seçicisi (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 global bin dizini, kabuğunuzun PATH değişkeninde değildir. Windows yolu da dahil olmak üzere çözümün tamamı için Node.js sorun giderme bölümüne bakın.

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