openclaw update

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

npm/pnpm/bun ile kurduysanız (genel kurulum, git meta verisi yok), güncellemeler Güncelleme bölümündeki paket yöneticisi akışıyla gerçekleşir.

Kullanım

openclaw updateopenclaw update statusopenclaw update repairopenclaw update wizardopenclaw update --channel betaopenclaw update --channel devopenclaw update --tag betaopenclaw update --tag mainopenclaw update --dry-runopenclaw update --no-restartopenclaw update --yesopenclaw update --acknowledge-clawhub-riskopenclaw update --jsonopenclaw --update

Seçenekler

• --no-restart: başarılı bir güncellemeden sonra Gateway hizmetini yeniden başlatmayı atlar.
• --channel <stable|beta|dev>: güncelleme kanalını ayarlar (git + npm; yapılandırmada kalıcılaştırılır).
• --tag <dist-tag|version|spec>: yalnızca bu güncelleme için paket hedefini geçersiz kılar.
• --dry-run: yapılandırma yazmadan, kurulum yapmadan, Plugin eşitlemeden veya yeniden başlatmadan planlanan güncelleme işlemlerini önizler.
• --json: makine tarafından okunabilir UpdateRunResult JSON çıktısı yazdırır.
• --timeout <seconds>: adım başına zaman aşımı (varsayılan 1800 sn).
• --yes: onay istemlerini atlar.
• --acknowledge-clawhub-risk: topluluk ClawHub güven uyarılarını inceledikten sonra, güncelleme sonrası Plugin eşitlemesinin etkileşimli istem olmadan devam etmesine izin verir.

openclaw update komutunun --verbose bayrağı yoktur. Planlanan kanal/etiket/kurulum/yeniden başlatma işlemlerini önizlemek için --dry-run, makine tarafından okunabilir sonuçlar için --json, yalnızca kanal ve kullanılabilirlik ayrıntılarına ihtiyacınız olduğunda openclaw update status --json kullanın.

update status

Etkin güncelleme kanalını + git etiketi/dalı/SHA değerini (kaynak checkout'ları için) ve güncelleme kullanılabilirliğini gösterir.

openclaw update statusopenclaw update status --jsonopenclaw update status --timeout 10

Seçenekler:

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

update repair

Çekirdek paket zaten değiştikten ancak sonraki onarım işi temiz şekilde tamamlanmadıktan sonra güncelleme sonlandırmasını yeniden çalıştırır.

openclaw update repairopenclaw update repair --channel betaopenclaw update repair --acknowledge-clawhub-riskopenclaw update repair --json

Seçenekler:

• --channel <stable|beta|dev>: onarımdan önce güncelleme kanalını kalıcılaştırır ve Plugin yakınsamasını bu kanala göre çalıştırır.
• --json: makine tarafından okunabilir sonlandırma JSON çıktısı yazdırır.
• --timeout <seconds>: onarım adımları için zaman aşımı (varsayılan 1800).
• --yes: onay istemlerini atlar.
• --acknowledge-clawhub-risk: topluluk ClawHub güven uyarılarını inceledikten sonra, onarım sırasında Plugin yakınsamasının etkileşimli istem olmadan devam etmesine izin verir.
• --no-restart: update komutuyla uyumluluk için kabul edilir; repair Gateway'i hiçbir zaman yeniden başlatmaz.

openclaw update repair, openclaw doctor --fix çalıştırır, onarılan yapılandırmayı ve kurulum kayıtlarını yeniden yükler, etkin güncelleme kanalı için izlenen Plugin'leri eşitler, yönetilen npm Plugin kurulumlarını günceller, eksik yapılandırılmış Plugin yüklerini onarır, Plugin kayıt defterini yeniler ve yakınsanmış kurulum kaydı meta verilerini yazar.

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şlatmadır).

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 hizalı tutar:

• dev → bir git checkout'ı sağlar, günceller ve genel CLI'yi bu checkout'tan kurar.
• stable → npm'den latest kullanarak kurar.
• beta → npm dist-tag beta değerini tercih eder, ancak beta eksikse veya mevcut stable sürümden daha eskiyse latest değerine geri döner.

Gateway çekirdek otomatik güncelleyicisi (yapılandırma üzerinden etkinleştirildiğinde), CLI güncelleme yolunu canlı Gateway istek işleyicisinin dışında başlatır.

Paket yöneticisi kurulumları için openclaw update, paket yöneticisini çağırmadan önce hedef paket sürümünü çözer. npm genel kurulumları aşamalı kurulum kullanır: OpenClaw yeni paketi geçici bir npm önekine kurar, paketlenmiş dist envanterini orada doğrular, ardından bu temiz paket ağacını gerçek genel öneke taşır.

Yerel yönetilen Gateway hizmeti kurulu olduğunda ve yeniden başlatma etkin olduğunda, paket yöneticisi ve git-checkout güncellemeleri paket ağacını değiştirmeden veya checkout/derleme çıktısını değiştirmeden önce çalışan hizmeti durdurur. Güncelleyici daha sonra hizmet meta verilerini güncellenmiş kurulumdan yeniler, hizmeti yeniden başlatır ve Gateway: restarted and verified. bildirmeden önce yeniden başlatılan Gateway'i doğrular.

Kontrol düzlemi yanıt şekli

update.run, bir paket yöneticisi kurulumu veya denetimli git checkout üzerinde Gateway kontrol düzlemi üzerinden çağrıldığında, işleyici handoff başlatmasını Gateway çıktıktan sonra devam eden CLI güncellemesinden ayrı olarak bildirir:

• ok: true, result.status: "skipped", result.reason: "managed-service-handoff-started" ve handoff.status: "started" Gateway'in yönetilen hizmet handoff'unu oluşturduğu anlamına gelir.
• ok: false, result.reason: "managed-service-handoff-unavailable" ve handoff.status: "unavailable" OpenClaw'ın güvenli bir handoff için denetleyici hizmet sınırı ve kalıcı hizmet kimliği bulamadığı anlamına gelir.
• ok: false, result.reason: "managed-service-handoff-failed" Gateway'in handoff'u oluşturmaya çalıştığını ancak ayrılmış yardımcıyı başlatamadığını gösterir.

sentinel yükü Gateway çıkmadan önce yine yazılır ve CLI handoff'u, yönetilen hizmet yeniden başlatma sağlık denetimleri tamamlandıktan sonra aynı yeniden başlatma sentinel'ını günceller.

Git checkout akışı

Kanal seçimi

• stable: en son beta olmayan etiketi checkout eder, ardından derler ve doctor çalıştırır.
• beta: en son -beta etiketini tercih eder, ancak beta eksikse veya daha eskiyse en son stable etikete geri döner.
• dev: main dalını checkout eder, ardından fetch ve rebase yapar.

Güncelleme adımları

Beta güncelleme kanalında, default/latest çizgisini izleyen izlenen npm ve ClawHub Plugin kurulumları önce bir Plugin @beta sürümünü dener. Plugin'in beta sürümü yoksa OpenClaw kaydedilmiş default/latest tanımına geri döner ve bunu bir uyarı olarak bildirir. npm Plugin'leri için OpenClaw, beta paket mevcut olsa ancak kurulum doğrulamasından geçemese de geri döner. Bu Plugin geri dönüş uyarıları çekirdek güncellemenin başarısız olmasına neden olmaz. Tam sürümler ve açık etiketler yeniden yazılmaz.

--update kısaltması

openclaw --update, openclaw update olarak yeniden yazılır (kabuklar ve başlatıcı betikleri için kullanışlıdır).

İlgili

• openclaw doctor (git checkout'larında önce güncellemeyi çalıştırmayı önerir)
• Geliştirme kanalları
• Güncelleme
• CLI başvurusu