openclaw update

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

npm/pnpm/bun aracılığıyla yüklediyseniz (genel yükleme, git meta verisi yok), güncellemeler Güncelleme bölümünde açıklanan paket yöneticisi akışı üzerinden gerçekleştirilir.

Kullanım

openclaw updateopenclaw update statusopenclaw update repairopenclaw update wizardopenclaw update --channel extended-stableopenclaw 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

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

Seçenekler

--verbose bayrağı yoktur. Planlanan işlemleri önizlemek için --dry-run, makine tarafından okunabilir sonuçlar için --json ve yalnızca kanal/kullanılabilirlik için openclaw update status --json kullanın. Gateway konsol ayrıntı düzeyi (--verbose) ve dosya günlük düzeyi (logging.level: "debug"/"trace") birbirinden bağımsız ayarlardır; bkz. Gateway günlük kaydı.

update status

Etkin güncelleme kanalını, git etiketini/dalını/SHA'sını (yalnızca kaynak çalışma kopyalarında) ve güncelleme kullanılabilirliğini gösterin.

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

Extended-stable paket yüklemelerinde durum, ön plan güncellemesiyle aynı genel seçiciyi ve kesin paket doğrulamasını gerçekleştirir. Yüklü sürüm daha yeniyse ahead of extended-stable bildirebilir. JSON hataları registry.reason (selector_missing, selector_query_failed, exact_package_mismatch veya unsupported_git_channel) içerir.

update repair

Çekirdek paket zaten değiştirildikten ancak sonraki onarım çalışması düzgün tamamlanmadıktan sonra güncelleme sonlandırmasını yeniden çalıştırın. openclaw update yeni çekirdek paketi yüklediği hâlde çekirdek sonrası plugin eşitlemesi, yönetilen npm plugin meta verileri, kayıt defteri yenilemesi veya doctor onarımı yakınsamadığında desteklenen kurtarma yolu budur.

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

update repair, openclaw doctor --fix işlemini çalıştırır, onarılan yapılandırmayı ve yükleme kayıtlarını yeniden yükler, izlenen plugin'leri etkin güncelleme kanalı için eşitler, yönetilen npm plugin yüklemelerini günceller, eksik yapılandırılmış plugin yüklerini onarır, plugin kayıt defterini yeniler ve yakınsanmış yükleme kaydı meta verilerini yazar. Yeni bir çekirdek paket yüklemez ve Gateway'i yeniden başlatmaz.

update wizard

Bir güncelleme kanalı seçmek ve ardından Gateway'in yeniden başlatılıp başlatılmayacağını onaylamak için etkileşimli akış (varsayılan olarak yeniden başlatılır). Git çalışma kopyası olmadan dev seçildiğinde bir tane oluşturulması önerilir.

Ne yapar?

Kanallar arasında açıkça geçiş yapılması (--channel ...), yükleme yöntemini de uyumlu tutar:

• dev -> bir git çalışma kopyasının bulunmasını sağlar (varsayılan ~/openclaw veya OPENCLAW_HOME ayarlandığında $OPENCLAW_HOME/openclaw; OPENCLAW_GIT_DIR ile geçersiz kılın), bunu günceller ve genel CLI'ı bu çalışma kopyasından yükler.
• stable -> latest kullanarak npm'den yükler.
• extended-stable -> genel npm extended-stable seçicisini çözümler, seçilen kesin paketi doğrular ve tam olarak bu sürümü yükler. Başka bir seçiciye geri dönmez ve Git çalışma kopyalarında reddedilir.
• beta -> npm dist-tag beta değerini tercih eder; beta eksikse veya mevcut kararlı sürümden daha eskiyse latest değerine geri döner.

Yeniden başlatma devri

Gateway çekirdek otomatik güncelleyicisi (yapılandırma aracılığıyla etkinleştirildiğinde), CLI güncelleme yolunu canlı Gateway istek işleyicisinin dışında başlatır. Denetim düzlemi update.run paket yöneticisi güncellemeleri ve denetlenen git çalışma kopyası güncellemeleri, canlı Gateway işlemi içinde paket ağacını değiştirmek veya dist/ öğesini yeniden oluşturmak yerine aynı yönetilen hizmet devrini kullanır: Gateway ayrılmış bir yardımcı başlatıp çıkar ve bu yardımcı openclaw update --yes --json işlemini Gateway işlem ağacının dışından çalıştırır. Devir kullanılamıyorsa update.run, elle çalıştırılacak güvenli kabuk komutunu içeren yapılandırılmış bir yanıt döndürür.

Saklanan extended-stable seçimler, update.checkOnStart etkinleştirildiğinde başlangıçta ve 24 saatlik aralıklarla salt okunur güncelleme ipuçları alır. Bu kontroller hiçbir zaman güncelleme uygulamaz, devir başlatmaz, Gateway'i yeniden başlatmaz, kararlı sürüm gecikmesi/jitter'ı kullanmaz veya beta yoklama sıklığını kullanmaz. Açık ön plan güncellemeleri, saklanan update.channel: "extended-stable" ile yalın ön plan güncellemeleri, isteğe bağlı durum ve bunların yönetilen Gateway devri desteklenmeye devam eder.

Yerel bir yönetilen Gateway hizmeti kuruluysa ve yeniden başlatma etkinse, 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 ardından hizmet meta verilerini yeniler, hizmeti yeniden başlatır ve Gateway: restarted and verified. bildirmeden önce yeniden başlatılan Gateway'i doğrular. Paket yöneticisi güncellemeleri ayrıca yeniden başlatılan Gateway'in beklenen paket sürümünü bildirdiğini doğrular; git checkout güncellemeleri ise yeniden derlemeden sonra gateway sağlığını ve hizmetin hazır olmasını doğrular.

Paket yöneticisi güncellemeleri normalde yönetilen hizmette kayıtlı Node ikilisini kullanmaya devam eder. Bu Node hedef sürümü çalıştıramıyorsa ancak mevcut CLI Node çalıştırabiliyorsa ve hizmetin güncellenen pakete ait olduğu kanıtlanmışsa, yeniden başlatma etkin bir güncelleme sonlandırma için mevcut Node'u kullanır ve hizmet meta verilerini bu çalışma zamanına göre yeniden yazar. --no-restart hizmet meta verilerini onaramaz; bu nedenle aynı çalışma zamanı uyumsuzluğu paket değiştirilmeden önce işlemi durdurur.

macOS'ta güncelleme sonrası kontrol ayrıca LaunchAgent'ın etkin profil için yüklü/çalışır durumda olduğunu ve yapılandırılmış geri döngü portunun sağlıklı olduğunu doğrular. Plist kurulu ancak launchd tarafından denetlenmiyorsa OpenClaw, LaunchAgent'ı otomatik olarak yeniden önyükler ve sağlık/sürüm/ kanal hazır olma kontrollerini yeniden çalıştırır (yeni bir önyükleme RunAtLoad işini doğrudan yükler, bu nedenle kurtarma yeni oluşturulan Gateway'i hemen kickstart -k etmez). Gateway yine de sağlıklı duruma gelmezse komut sıfır dışı kodla çıkar ve yeniden başlatma günlük yoluyla birlikte yeniden başlatma, yeniden kurma ve paket geri alma talimatlarını yazdırır.

Yeniden başlatma çalıştırılamazsa komut, manuel openclaw gateway restart ipucuyla birlikte Gateway: restart skipped (...) veya Gateway: restart failed: ... yazdırır. --no-restart ile paket değiştirme veya git yeniden derleme yine çalışır ancak yönetilen hizmet durdurulmaz veya yeniden başlatılmaz; dolayısıyla çalışan Gateway, siz manuel olarak yeniden başlatana kadar eski kodu kullanmaya devam eder.

Kontrol düzlemi yanıt biçimi

update.run, bir paket yöneticisi kurulumu veya denetlenen git checkout üzerinde Gateway kontrol düzlemi üzerinden çalıştığında işleyici, Gateway çıktıktan sonra devam eden CLI güncellemesinden devir başlatmayı ayrı olarak bildirir:

• ok: true, result.status: "skipped", result.reason: "managed-service-handoff-started" ve handoff.status: "started": Gateway, yönetilen hizmet devrini oluşturdu ve ayrılmış yardımcının canlı hizmet işlemi dışında openclaw update --yes --json çalıştırabilmesi için kendi yeniden başlatmasını zamanladı.
• ok: false, result.reason: "managed-service-handoff-unavailable" ve handoff.status: "unavailable": OpenClaw güvenli bir devir için denetleyici hizmet sınırı ve kalıcı hizmet kimliği bulamadı (örneğin systemd devri yalnızca ortam systemd işlem işaretçilerini değil, OPENCLAW_SYSTEMD_UNIT birim kimliğini gerektirir). Yanıt, Gateway dışından çalıştırılacak kabuk komutu olan handoff.command değerini içerir.
• ok: false, result.reason: "managed-service-handoff-failed": Gateway devri oluşturmayı denedi ancak ayrılmış yardımcıyı başlatamadı.

sentinel yükü Gateway çıkmadan önce yazılır ve CLI devri, yönetilen hizmetin yeniden başlatma sağlık kontrolleri tamamlandıktan sonra aynı yeniden başlatma nöbetçisini günceller. Devir sırasında nöbetçi, başarı devamı olmadan stats.reason: "restart-health-pending" taşıyabilir; yeniden başlatılan Gateway bunu yoklar ve yalnızca CLI hizmet sağlığını doğrulayıp nöbetçiyi nihai ok sonucuyla yeniden yazdıktan sonra devamı tetikler. openclaw status ve openclaw status --all, bu nöbetçi beklemede veya başarısızken bir Update restart satırı gösterir; update.status ise yenileyip en son nöbetçiyi döndürür.

Git checkout akışı

Kanal seçimi

• stable: en son beta olmayan etiketi checkout yapar, ardından derler ve doctor'ı çalıştırır.
• beta: en son -beta etiketini tercih eder; beta yoksa veya daha eskiyse en son kararlı etikete geri döner.
• dev: main checkout yapar, ardından getirir ve rebase eder.
• extended-stable: Git checkout'ları için desteklenmez; checkout üzerinde değişiklik yapılmaz.

Güncelleme adımları

Plugin eşitleme ayrıntıları

Beta kanalında, varsayılan/en son hattı izleyen takip edilen 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/en son tanıma geri döner ve bir uyarı bildirir. OpenClaw, npm Plugin'lerinde beta paketi mevcut olup kurulum doğrulamasında başarısız olduğunda da geri döner. Bu geri dönüş uyarıları çekirdek güncellemesinin başarısız olmasına neden olmaz. Kesin sürümler ve açık etiketler hiçbir zaman yeniden yazılmaz.

Bir extended-stable çekirdek güncellemesi başarıyla tamamlandıktan sonra çekirdek sonrası Plugin bütünlüğü ve yakınsama, uygun resmî npm Plugin'lerini tam kurulu çekirdek sürümünde hedefler. Varsayılan/latest amacı için OpenClaw, Plugin @extended-stable değerini sorgulamaz veya npm latest değerine geri dönmez; paket sürümünü kurulu çekirdekten türetir. Açık sürüm sabitlemeleri, açık latest olmayan etiketler, üçüncü taraf paketler ve npm dışı kaynaklar mevcut amaçlarını korur.

Paket yöneticisi kurulumları için openclaw update, paket yöneticisini çağırmadan önce hedef paket sürümünü çözümler. npm global kurulumları aşamalı kurulum kullanır: OpenClaw yeni paketi geçici bir npm önekine kurar, aday paketin preinstall sırasında ana makine Node sürümünü doğrulamasına izin verir ve buradaki paketlenmiş dist envanterini doğrular. Paketlenmiş bir tamamlama koruması preinstall başarılı olana kadar bu envanterin dışında kalır; böylece yaşam döngüsü betiklerini atlayan paket yöneticileri de etkinleştirmeden önce durur. npm 12 ve daha yeni sürümlerde güncelleyici yalnızca aday OpenClaw yaşam döngüsünü onaylar; geçişli bağımlılık betikleri engellenmiş kalır. OpenClaw daha sonra temiz paket ağacını gerçek global öneke geçirir. Doğrulama başarısız olursa güncelleme sonrası doctor, Plugin eşitleme ve yeniden başlatma işlemleri şü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şitlemeyi, çekirdek komut tamamlama yenilemesini ve yeniden başlatma işlemlerini çalıştırır. Bu, paketlenmiş yan 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.

İlgili

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