Ana içeriğe atla

​
Sistem gereksinimleri

  • Node 24 (önerilir) veya Node 22.19+ - kurulum betiği bunu otomatik olarak halleder
  • macOS, Linux veya Windows - Windows kullanıcıları yerel Windows Hub uygulaması, PowerShell CLI kurucusu veya WSL2 Gateway ile başlayabilir. Bkz. Windows.
  • pnpm yalnızca kaynaktan derleme yaparsanız gerekir

​
Önerilen: kurulum betiği

Kurmanın en hızlı yolu. İşletim sisteminizi algılar, gerekirse Node kurar, OpenClaw kurar ve ilk yapılandırmayı başlatır.
Windows masaüstü kullanıcıları ayrıca kurulum, tepsi durumu, sohbet, düğüm modu ve yerel MCP modunu içeren yerel Windows Hub yardımcı uygulamasını kurabilir.
curl -fsSL https://openclaw.ai/install.sh | bash
İlk yapılandırmayı çalıştırmadan kurmak için: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Tüm bayraklar ve CI/otomasyon seçenekleri için bkz. Kurucu iç yapısı.

​
Alternatif kurulum yöntemleri

​
Yerel önek kurucusu (install-cli.sh)

Sistem genelindeki bir Node kurulumuna bağlı kalmadan OpenClaw ve Node’un ~/.openclaw gibi yerel bir önek altında tutulmasını istediğinizde bunu kullanın: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Varsayılan olarak npm kurulumlarını ve aynı önek akışı altında git checkout kurulumlarını destekler. Tam başvuru: Kurucu iç yapısı. Zaten kurulu mu? Paket ve git kurulumları arasında openclaw update --channel dev ve openclaw update --channel stable ile geçiş yapın. Bkz. Güncelleme.

​
npm, pnpm veya bun

Node’u zaten kendiniz yönetiyorsanız: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Barındırılan kurucu, OpenClaw paket kurulumu için min-release-age gibi npm tazelik filtrelerini temizler. npm ile manuel kurulum yaparsanız kendi npm politikanız yine geçerlidir.

​
Kaynaktan

Katkıda bulunanlar veya yerel bir checkout’tan çalıştırmak isteyen herkes için: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Ya da bağlantı adımını atlayıp depo içinden pnpm openclaw ... kullanın. Tam geliştirme iş akışları için bkz. Kurulum.

​
GitHub main checkout’undan kurulum

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

​
Konteynerler ve paket yöneticileri

Docker

Konteynerleştirilmiş veya başsız dağıtımlar.

Podman

Docker’a köksüz konteyner alternatifi.

Nix

Nix flake ile bildirime dayalı kurulum.

Ansible

Otomatik filo hazırlama.

Bun

Bun çalışma zamanı üzerinden yalnızca CLI kullanımı.

​
Kurulumu doğrulama

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
Kurulumdan sonra yönetilen başlatma istiyorsanız:
  • macOS: openclaw onboard --install-daemon veya openclaw gateway install ile LaunchAgent
  • Linux/WSL2: Aynı komutlarla systemd kullanıcı servisi
  • Yerel Windows: Önce Zamanlanmış Görev, 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:

VPS

Herhangi bir Linux VPS.

Docker VM

Paylaşılan Docker adımları.

Kubernetes

K8s dağıtımı.

Fly.io

Fly.io üzerinde dağıtın.

Hetzner

Hetzner dağıtımı.

GCP

Google Cloud dağıtımı.

Azure

Azure dağıtımı.

Railway

Railway dağıtımı.

Render

Render dağıtımı.

Northflank

Northflank dağıtımı.

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

Updating

OpenClaw’u güncel tutun.

Migrating

Yeni bir makineye taşıyın.

Uninstall

OpenClaw’u tamamen kaldırın.

​
Sorun giderme: openclaw bulunamadı

Kurulum başarılı olduysa ancak terminalinizde openclaw bulunamıyorsa: 
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
$(npm prefix -g)/bin, $PATH içinde değilse kabuk başlangıç dosyanıza (~/.zshrc veya ~/.bashrc) ekleyin: 
export PATH="$(npm prefix -g)/bin:$PATH"
Ardından yeni bir terminal açın. Daha fazla ayrıntı için bkz. Node kurulumu.