Skip to main content

​
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 gerçekleştirir.
  • macOS, Linux veya Windows - Windows kullanıcıları yerel Windows Hub uygulaması, PowerShell CLI yükleyicisi 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’ı yükler ve ilk kurulumu başlatır.
Windows masaüstü kullanıcıları; kurulum, sistem tepsisi durumu, sohbet, Node modu ve yerel MCP modunu içeren yerel Windows Hub yardımcı uygulamasını da yükleyebilir.
İlk kurulumu çalıştırmadan yüklemek için:
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 yüklemesine bağlı olmadan ~/.openclaw gibi yerel bir önek altında tutmak istediğinizde bunu kullanın:
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 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:
Barındırılan yükleyici, OpenClaw paket yüklemesi için min-release-age gibi npm güncellik filtrelerini temizler. npm ile elle yükleme yaparsanız kendi npm politikanız geçerliliğini korur.

​
Kaynaktan

Katkıda bulunanlar veya yerel bir çalışma kopyasından çalıştırmak isteyenler için:
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

​
Kapsayıcılar ve paket yöneticileri

Docker

Kapsayıcı tabanlı veya grafik arayüzsüz dağıtımlar.

Podman

Docker’a köksüz kapsayıcı alternatifi.

Nix

Nix flake aracılığıyla bildirimsel yükleme.

Ansible

Otomatik filo sağlama.

Bun

İsteğe bağlı bağımlılık yükleyicisi ve paket betiği çalıştırıcısı.

​
Yüklemeyi doğrulama

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 Zamanlanmış Görev; görev oluşturma reddedilirse kullanıcı başına Başlangıç klasörü oturum açma öğesi yedeği

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

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

VPS

Bir sağlayıcı seçin.

Docker VM

Paylaşılan Docker adımları.

Kubernetes

K8s dağıtımı.

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

Güncelleme

OpenClaw’ı güncel tutun.

Taşıma

Yeni bir makineye taşıyın.

Kaldırma

OpenClaw’ı tamamen kaldırın.

​
Sorun giderme: openclaw bulunamadı

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.