English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Kurulum

Sistem gereksinimleri

  • Node 24 (önerilir) veya Node 22.14+ - 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.
  • pnpm yalnızca kaynaktan derleme yaparsanız gerekir

Önerilen: yükleyici betiği

Kurmanın en hızlı yolu. İşletim sisteminizi algılar, gerekirse Node yükler, OpenClaw'u kurar ve başlangıç yapılandırmasını başlatır.

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Başlangıç yapılandırmasını çalıştırmadan kurmak için:

macOS / Linux / WSL2

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

Windows (PowerShell)

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Tüm bayraklar ve CI/otomasyon seçenekleri için bkz. Yükleyici iç ayrıntıları.

Alternatif kurulum yöntemleri

Yerel önek yükleyicisi (install-cli.sh)

OpenClaw ve Node'un sistem genelindeki bir Node kurulumuna bağlı olmadan ~/.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: Yükleyici iç 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@latest
openclaw onboard --install-daemon

pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun

bun add -g openclaw@latest
openclaw onboard --install-daemon
Troubleshooting: sharp build errors (npm)

sharp, global olarak kurulmuş libvips nedeniyle başarısız olursa:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

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

Alternatif olarak link adımını atlayıp depo içinden pnpm openclaw ... kullanın. Tam geliştirme iş akışları için bkz. Kurulum.

GitHub main dalından kurulum

npm install -g github:openclaw/openclaw#main

Konteynerler ve paket yöneticileri

Docker

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

Docker'a root'suz konteyner alternatifi.
Nix

Nix flake ile bildirimsel kurulum.
Ansible

Otomatik filo hazırlama.
Bun

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

Kurulumu doğrulayın

openclaw --version      # CLI'nin kullanılabilir olduğunu doğrulayın
openclaw doctor         # yapılandırma sorunlarını denetleyin
openclaw gateway status # Gateway'in çalıştığını doğrulayın

Kurulumdan sonra yönetilen başlatma istiyorsanız:

  • macOS: openclaw onboard --install-daemon veya openclaw gateway install üzerinden LaunchAgent
  • Linux/WSL2: aynı komutlar üzerinden 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'u bir bulut sunucusuna veya VPS'e dağıtın:

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii90ci9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

Güncelleyin, taşıyın veya kaldırın

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 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 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.