# openclaw update

OpenClaw'u güvenle güncelleyin ve stable/beta/dev kanalları arasında geçiş yapın.

npm/pnpm/bun ile kurduysanız (global kurulum, git meta verisi yok), güncellemeler Updating içindeki paket yöneticisi akışıyla yapılır.

# Kullanım

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --tag main
openclaw update --dry-run
openclaw update --no-restart
openclaw update --yes
openclaw update --json
openclaw --update

# Seçenekler

• --no-restart: başarılı bir güncellemeden sonra Gateway hizmetini yeniden başlatmayı atla. Gateway'i yeniden başlatan paket yöneticisi güncellemeleri, komut başarılı olmadan önce yeniden başlatılan hizmetin beklenen güncellenmiş sürümü bildirdiğini doğrular.
• --channel <stable|beta|dev>: güncelleme kanalını ayarla (git + npm; config içinde kalıcı tutulur).
• --tag <dist-tag|version|spec>: paket hedefini yalnızca bu güncelleme için geçersiz kıl. Paket kurulumlarında main, github:openclaw/openclaw#main ile eşleşir.
• --dry-run: config yazmadan, kurulum yapmadan, Plugin'leri eşitlemeden veya yeniden başlatmadan planlanan güncelleme eylemlerini (kanal/tag/hedef/yeniden başlatma akışı) önizle.
• --json: çekirdek güncelleme başarılı olduktan sonra bozuk veya yüklenemeyen yönetilen Plugin'lerin onarım gerektirdiği durumlarda postUpdate.plugins.warnings ve güncelleme sonrası Plugin eşitlemesi sırasında npm Plugin yapıtı sapması algılandığında postUpdate.plugins.integrityDrifts dahil olmak üzere makine tarafından okunabilir UpdateRunResult JSON'unu yazdır.
• --timeout <seconds>: adım başına zaman aşımı (varsayılan 1800s).
• --yes: onay istemlerini atla (örneğin sürüm düşürme onayı).

openclaw update komutunun --verbose bayrağı yoktur. Planlanan kanal/tag/kurulum/yeniden başlatma eylemlerini önizlemek için --dry-run, makine tarafından okunabilir sonuçlar için --json ve yalnızca kanal ile kullanılabilirlik ayrıntılarına ihtiyacınız olduğunda openclaw update status --json kullanın. Bir güncelleme etrafında Gateway günlüklerinde hata ayıklıyorsanız, konsol ayrıntı düzeyi ile dosya günlük düzeyi ayrıdır: Gateway --verbose, terminal/WebSocket çıktısını etkilerken dosya günlükleri config içinde logging.level: "debug" veya "trace" gerektirir. Bkz. Gateway logging.

# update status

Etkin güncelleme kanalını + git tag/branch/SHA bilgisini (kaynak checkout'ları için) ve güncelleme kullanılabilirliğini göster.

openclaw update status
openclaw update status --json
openclaw update status --timeout 10

Seçenekler:

• --json: makine tarafından okunabilir durum JSON'unu yazdır.
• --timeout <seconds>: kontroller için zaman aşımı (varsayılan 3s).

# update wizard

Bir güncelleme kanalı seçmek ve güncellemeden sonra Gateway'in yeniden başlatılıp başlatılmayacağını onaylamak için etkileşimli akış (varsayılan yeniden başlatmaktır). Git checkout olmadan dev seçerseniz, bir tane oluşturmayı önerir.

Seçenekler:

• --timeout <seconds>: her güncelleme adımı için zaman aşımı (varsayılan 1800)

# Ne yapar?

Kanalları açıkça değiştirdiğinizde (--channel ...), OpenClaw kurulum yöntemini de uyumlu tutar:

• dev → bir git checkout olmasını sağlar (varsayılan: ~/openclaw, OPENCLAW_GIT_DIR ile geçersiz kılınır), onu günceller ve global CLI'ı bu checkout'tan kurar.
• stable → npm'den latest kullanarak kurar.
• beta → npm dist-tag beta tercih eder, ancak beta yoksa veya geçerli stable sürümden eskiyse latest sürümüne geri döner.

Gateway çekirdek otomatik güncelleyicisi (config üzerinden etkinleştirildiğinde), CLI güncelleme yolunu canlı Gateway istek işleyicisinin dışında başlatır. Kontrol düzlemi update.run paket yöneticisi güncellemeleri, paket değişiminden sonra ertelenmeyen ve bekleme süresi olmayan bir güncelleme yeniden başlatmasını zorunlu kılar; çünkü eski Gateway işleminin belleğinde hâlâ yeni paket tarafından kaldırılmış dosyalara işaret eden parçalar olabilir.

Paket yöneticisi kurulumlarında openclaw update, paket yöneticisini çağırmadan önce hedef paket sürümünü çözer. npm global kurulumları aşamalı bir kurulum kullanır: OpenClaw yeni paketi geçici bir npm prefix içine kurar, oradaki paketlenmiş dist envanterini doğrular, sonra bu temiz paket ağacını gerçek global prefix içine değiştirir. Doğrulama başarısız olursa, güncelleme sonrası doctor, Plugin eşitlemesi ve yeniden başlatma işleri şüpheli ağaçtan çalıştırılmaz. Kurulu sürüm hedefle zaten eşleşse bile, komut global paket kurulumunu yeniler, ardından Plugin eşitlemesini, çekirdek komut tamamlama yenilemesini ve yeniden başlatma işlerini çalıştırır. Bu, paketlenmiş yardımcı bileşenleri ve kanalın sahip olduğu Plugin kayıtlarını kurulu OpenClaw derlemesiyle uyumlu tutarken tam Plugin komutu tamamlama yeniden derlemelerini açık openclaw completion --write-state çalıştırmalarına bırakır.

Yerel yönetilen bir Gateway hizmeti kuruluysa ve yeniden başlatma etkinse, paket yöneticisi güncellemeleri paket ağacını değiştirmeden önce çalışan hizmeti durdurur, sonra güncellenmiş kurulumdan hizmet meta verilerini yeniler, hizmeti yeniden başlatır ve başarı bildirmeden önce yeniden başlatılan Gateway'in beklenen sürümü bildirdiğini doğrular. macOS'ta güncelleme sonrası kontrol ayrıca LaunchAgent'ın etkin profil için yüklenmiş/çalışıyor olduğunu ve yapılandırılmış loopback portunun sağlıklı olduğunu doğrular. plist kuruluysa ancak launchd onu denetlemiyorsa, OpenClaw LaunchAgent'ı otomatik olarak yeniden bootstrap eder, ardından sağlık/sürüm/kanal hazır olma kontrollerini yeniden çalıştırır. Yeni bir bootstrap, RunAtLoad işini doğrudan yükler; bu yüzden güncelleme kurtarma yeni oluşturulan Gateway için hemen kickstart -k çalıştırmaz. Gateway hâlâ sağlıklı hale gelmezse, komut sıfır olmayan kodla çıkar ve yeniden başlatma günlük yolunu, ayrıca açık yeniden başlatma, yeniden kurulum ve paket geri alma talimatlarını yazdırır. --no-restart ile paket değişimi yine çalışır, ancak yönetilen hizmet durdurulmaz veya yeniden başlatılmaz; bu yüzden çalışan Gateway siz elle yeniden başlatana kadar eski kodu kullanmaya devam edebilir.

# Git checkout akışı

# Kanal seçimi

• stable: en son beta olmayan tag'e checkout yapar, ardından derleme ve doctor çalıştırır.
• beta: en son -beta tag'ini tercih eder, ancak beta yoksa veya eskiyse en son stable tag'e geri döner.
• dev: main dalına checkout yapar, ardından fetch ve rebase çalıştırır.

# Güncelleme adımları

Beta güncelleme kanalında, varsayılan/latest hattını izleyen izlenen npm ve ClawHub Plugin kurulumları önce bir Plugin @beta sürümünü dener. Plugin'in beta sürümü yoksa, OpenClaw kayıtlı varsayılan/latest spec değerine geri döner. npm Plugin'leri için OpenClaw, beta paketi mevcut olup kurulum doğrulamasında başarısız olduğunda da geri döner. Kesin sürümler ve açık tag'ler yeniden yazılmaz.

# --update kısayolu

openclaw --update, openclaw update olarak yeniden yazılır (shell'ler ve başlatıcı script'ler için kullanışlıdır).

# İlgili

• openclaw doctor (git checkout'larında önce güncelleme çalıştırmayı önerir)
• Development channels
• Updating
• CLI reference