Ana içeriğe atla

​
Kurulum

​
Önerilen: kurulum betiği

Kurmanın en hızlı yolu. İşletim sisteminizi algılar, gerekirse Node kurar, OpenClaw’ı kurar ve onboarding’i başlatır. 
curl -fsSL https://openclaw.ai/install.sh | bash
Onboarding’i ç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. Installer internals.

​
Sistem gereksinimleri

  • Node 24 (önerilir) veya Node 22.14+ — kurulum betiği bunu otomatik olarak halleder
  • macOS, Linux veya Windows — hem yerel Windows hem de WSL2 desteklenir; WSL2 daha kararlıdır. Bkz. Windows.
  • pnpm yalnızca kaynaktan derleme yapıyorsanız gerekir

​
Alternatif kurulum yöntemleri

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

OpenClaw ve Node’u sistem geneline kurulmuş bir Node’a bağımlı olmadan ~/.openclaw gibi yerel bir önek altında tutmak istiyorsanız 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: Installer internals.

​
npm, pnpm veya bun

Node’u zaten kendiniz yönetiyorsanız: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
sharp, global olarak kurulmuş bir libvips nedeniyle başarısız olursa:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Kaynaktan

Katkıda bulunanlar veya yerel checkout üzerinden çalıştırmak isteyen herkes için: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
Veya link vermeyi atlayıp depo içinden pnpm openclaw ... kullanın. Tam geliştirme akışları için Setup bölümüne bakın.

​
GitHub main üzerinden kurulum

npm install -g github:openclaw/openclaw#main

​
Kapsayıcılar ve paket yöneticileri

Docker

Kapsayıcılaştırılmış veya headless dağıtımlar.

Podman

Docker’a rootless kapsayıcı alternatifi.

Nix

Nix flake üzerinden bildirime dayalı kurulum.

Ansible

Otomatik filo sağlama.

Bun

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

​
Kurulumu doğrulayın

openclaw --version      # CLI kullanılabilir mi doğrula
openclaw doctor         # config sorunlarını denetle
openclaw gateway status # Gateway'in çalıştığını doğrula
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ı hizmeti
  • Yerel Windows: önce Scheduled Task, görev oluşturma reddedilirse kullanıcı başına Startup-folder oturum açma öğesi yedeği

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

OpenClaw’ı bir bulut sunucusunda veya VPS üzerinde dağıtın:

VPS

Herhangi bir Linux VPS

Docker VM

Paylaşılan Docker adımları

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Güncelleme, geçiş veya kaldırma

Updating

OpenClaw’ı güncel tutun.

Migrating

Yeni bir makineye taşıyın.

Uninstall

OpenClaw’ı tamamen kaldırın.

​
Sorun giderme: openclaw bulunamadı

Kurulum başarılı olduysa ancak terminalinizde openclaw bulunamıyorsa: 
node -v           # Node kurulu mu?
npm prefix -g     # Global paketler nerede?
echo "$PATH"      # Global bin dizini PATH içinde mi?
$(npm prefix -g)/bin, $PATH içinde değilse bunu 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 Node setup bölümüne bakın.