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

Node 22+ (eksikse yükleyici betiği kurar)
macOS, Linux veya Windows
Yalnızca kaynaktan derleme yapacaksanız pnpm

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.

macOS / Linux / WSL2
Windows (PowerShell)

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

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

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:

macOS / Linux / WSL2
Windows (PowerShell)

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

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

Tüm bayraklar, ortam değişkenleri ve CI/otomasyon seçenekleri için Yükleyici iç detayları sayfasına bakın.

npm / pnpm

Zaten Node 22+ yüklüyse ve kurulumu kendiniz yönetmek istiyorsanız:

npm
pnpm

npm install -g openclaw@latest
openclaw onboard --install-daemon

sharp derleme hataları mı?

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.

pnpm add -g openclaw@latest
pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
openclaw onboard --install-daemon

pnpm, derleme betikleri olan paketler için açık onay gerektirir. İlk kurulumda “Ignored build scripts” uyarısı göründükten sonra pnpm approve-builds -g komutunu çalıştırın ve listelenen paketleri seçin.

From source

Katkıda bulunanlar veya yerel bir kopyadan çalıştırmak isteyen herkes için.

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

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.

İ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ı

PATH diagnosis and fix

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.

Kurulum genel bakış

Diğer kurulum yöntemleri

Bakım

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

Gelişmiş

Kurulum

Kurulum

Sistem gereksinimleri

Kurulum yöntemleri

Diğer kurulum yöntemleri

Docker

Podman

Nix

Ansible

Bun

Kurulumdan sonra

Sorun Giderme: `openclaw` bulunamadı

Güncelleme / kaldırma

Updating

Migrating

Uninstall

​Kurulum

​Sistem gereksinimleri

​Kurulum yöntemleri

​Diğer kurulum yöntemleri

Docker

Podman

Nix

Ansible

Bun

​Kurulumdan sonra

​Sorun Giderme: openclaw bulunamadı

​Güncelleme / kaldırma

Updating

Migrating

Uninstall

Kurulum

Sistem gereksinimleri

Kurulum yöntemleri

Diğer kurulum yöntemleri

Kurulumdan sonra

Sorun Giderme: `openclaw` bulunamadı

Güncelleme / kaldırma