Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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 pnpm gerekir

​
Ö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. 
curl -fsSL https://openclaw.ai/install.sh | bash
İlk kurulumu ç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. 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 | bash
Varsayı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 install -g openclaw@latest
openclaw onboard --install-daemon
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 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#main

​
Kapsayıcılar ve paket yöneticileri

Docker

Kapsayıcılı veya başsız dağıtımlar.

Podman

Docker’a root yetkisi gerektirmeyen kapsayıcı 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ğrulama

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şlangıç istiyorsanız:
  • macOS: openclaw onboard --install-daemon veya openclaw gateway install ile 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:

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, taşıma 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 bkz. Node kurulumu.