Kurulum

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.

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

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

İlk yapılandırmayı çalıştırmadan kurmak 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 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@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 checkout'tan çalıştırmak isteyen herkes için:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw 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

Kurulumu doğrulama

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw 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:

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

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.