Install overview
Kurulum
Sistem gereksinimleri
- Node 24 (önerilir) veya Node 22.16+ - yükleyici betiği bunu otomatik olarak halleder
- macOS, Linux veya Windows - hem yerel Windows hem de WSL2 desteklenir; WSL2 daha kararlıdır. Bkz. Windows.
- Kaynaktan derleme yapıyorsanız yalnızca
pnpmgerekir
Önerilen: yükleyici betiği
Kurulumun en hızlı yolu. İşletim sisteminizi algılar, gerekirse Node kurar, OpenClaw'ı kurar ve ilk kurulumu başlatır.
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexİlk kurulumu çalıştırmadan kurmak için:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboardWindows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardTüm bayraklar ve CI/otomasyon seçenekleri için bkz. Yükleyici ayrıntıları.
Alternatif kurulum yöntemleri
Yerel önek yükleyicisi (install-cli.sh)
OpenClaw ve Node'un, sistem geneline kurulu bir Node'a bağımlı olmadan
~/.openclaw gibi yerel bir önek altında tutulmasını istediğinizde bunu kullanın:
curl -fsSL https://openclaw.ai/install-cli.sh | bashVarsayılan olarak npm kurulumlarını ve aynı önek akışı altında git-checkout kurulumlarını destekler. Tam başvuru: Yükleyici ayrıntıları.
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
npm install -g openclaw@latestopenclaw onboard --install-daemonpnpm
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemonbun
bun add -g openclaw@latestopenclaw onboard --install-daemonTroubleshooting: sharp build errors (npm)
sharp, global olarak kurulmuş libvips nedeniyle başarısız olursa:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latestKaynaktan
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-daemonAlternatif olarak link adımını atlayıp repo içinden pnpm openclaw ... kullanabilirsiniz. Tam geliştirme iş akışları için bkz. Kurulum.
GitHub main dalından kurulum
npm install -g github:openclaw/openclaw#mainKapsayıcılar ve paket yöneticileri
Kapsayıcılı veya başsız dağıtımlar.
Docker'a root yetkisi gerektirmeyen kapsayıcı alternatifi.
Nix flake ile bildirimsel kurulum.
Otomatik filo hazırlama.
Bun çalışma zamanı üzerinden yalnızca CLI kullanımı.
Kurulumu 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ınKurulumdan sonra yönetilen başlangıç istiyorsanız:
- macOS:
openclaw onboard --install-daemonveyaopenclaw gateway installile LaunchAgent - Linux/WSL2: aynı komutlarla systemd kullanıcı hizmeti
- 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'ı bir bulut sunucusuna veya VPS'ye dağıtın:
Güncelleme, taşıma veya kaldırma
OpenClaw'ı güncel tutun.
Yeni bir makineye taşıyın.
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 bkz. Node kurulumu.