Ana içeriğe atla

​
Kurulum

Başlarken adımını zaten tamamladınız mı? Hazırsınız — bu sayfa alternatif kurulum yöntemleri, platforma özgü talimatlar ve bakım içindir.

​
Sistem gereksinimleri

Windows’ta OpenClaw’ı WSL2 altında çalıştırmanızı önemle öneririz.

​
Kurulum yöntemleri

Yükleyici betiği, OpenClaw’ı kurmanın önerilen yoludur. Node algılama, kurulum ve ilk katılımı tek adımda gerçekleştirir.

Yükleyici betiği

CLI’yi indirir, npm ile global olarak kurar ve tanıtım sihirbazını başlatır.
curl -fsSL https://openclaw.ai/install.sh | bash
Hepsi bu — betik Node algılama, kurulum ve ilk katılımı yönetir.İlk katılımı atlayıp yalnızca ikiliyi kurmak için:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Tüm bayraklar, ortam değişkenleri ve CI/otomasyon seçenekleri için Yükleyici iç detayları sayfasına bakın.
Zaten Node 22+ yüklüyse ve kurulumu kendiniz yönetmek istiyorsanız:
npm install -g openclaw@latest
openclaw onboard --install-daemon
libvips’i küresel olarak kuruluysa (macOS’ta Homebrew ile yaygındır) ve sharp başarısız oluyorsa, önceden derlenmiş ikilileri zorlayın:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
sharp: Please add node-gyp to your dependencies görürseniz, ya derleme araçlarını kurun (macOS: Xcode CLT + npm install -g node-gyp) ya da yukarıdaki ortam değişkenini kullanın.
Katkıda bulunanlar veya yerel bir kopyadan çalıştırmak isteyen herkes için.
1

Klonla ve derle

OpenClaw deposunu klonlayın ve derleyin:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2

CLI'yi bağla

openclaw komutunu küresel olarak kullanılabilir yapın:
pnpm link --global
Alternatif olarak, bağlantıyı atlayıp komutları depo içinden pnpm openclaw ... ile çalıştırabilirsiniz.
3

İlk katılımı çalıştır

openclaw onboard --install-daemon
Daha derin geliştirme iş akışları için Kurulum sayfasına bakın.

​
Diğer kurulum yöntemleri

Docker

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

Podman

Rootless container: run setup-podman.sh once, then the launch script.

Nix

Nix ile bildirime dayalı kurulum.

Ansible

Otomatik filo sağlama.

Bun

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

​
Kurulumdan sonra

Her şeyin çalıştığını doğrulayın: 
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI
Özel çalışma zamanı yollarına ihtiyacınız varsa şunları kullanın:
  • OPENCLAW_HOME ev dizini tabanlı dahili yollar için
  • OPENCLAW_STATE_DIR değiştirilebilir durum konumu için
  • OPENCLAW_CONFIG_PATH yapılandırma dosyası konumu için
Öncelik sırası ve tüm ayrıntılar için Environment vars sayfasına bakın.

​
Sorun Giderme: openclaw bulunamadı

Hızlı tanı:
node -v
npm -v
npm prefix -g
echo "$PATH"
$(npm prefix -g)/bin (macOS/Linux) veya $(npm prefix -g) (Windows) $PATH içinde değilse, kabuğunuz global npm ikililerini (openclaw dahil) bulamaz.Düzeltme — kabuk başlangıç dosyanıza (~/.zshrc veya ~/.bashrc) ekleyin:
export PATH="$(npm prefix -g)/bin:$PATH"
Windows’ta, npm prefix -g çıktısını PATH’inize ekleyin.Ardından yeni bir terminal açın (veya zsh’te rehash / bash’te hash -r).

​
Güncelleme / kaldırma

Updating

OpenClaw’ı güncel tutun.

Migrating

Yeni bir makineye geçin.

Uninstall

OpenClaw’ı tamamen kaldırın.