OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Güncelleme

openclaw update

OpenClaw'ı 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

bash
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

Bayrak Açıklama
--no-restart Başarılı bir güncellemeden sonra Gateway hizmetini yeniden başlatmayı atlayın. Yeniden başlatma yapan paket yöneticisi güncellemeleri, komut başarıyla tamamlanmadan önce yeniden başlatılan hizmetin beklenen sürümü bildirdiğini doğrular.
--channel <stable|extended-stable|beta|dev> Güncelleme kanalını ayarlayın ve çekirdek güncellemesi başarıyla tamamlandıktan sonra kalıcı hâle getirin. Extended-stable yalnızca paketler içindir.
--tag <dist-tag|version|spec> Yalnızca bu güncelleme için paket hedefini geçersiz kılın. Doğrulanmış kesin hedefi zorunlu olan etkin bir extended-stable kanalıyla birlikte kullanılamaz. Diğer paket yüklemelerinde main, github:openclaw/openclaw#main ile eşlenir; GitHub/git kaynak belirtimleri, aşamalı genel npm yüklemesinden önce geçici bir tarball olarak paketlenir.
--dry-run Yapılandırmaya yazmadan, yükleme yapmadan, plugin'leri eşitlemeden veya yeniden başlatmadan planlanan eylemleri (kanal/etiket/hedef/yeniden başlatma akışı) önizleyin.
--json Makine tarafından okunabilir UpdateRunResult JSON verisini yazdırın. Yönetilen bir plugin'in onarılması gerektiğinde postUpdate.plugins.warnings, beta kanalı plugin geri dönüş ayrıntıları ve güncelleme sonrası eşitleme sırasında npm plugin yapıtı sapması algılandığında postUpdate.plugins.integrityDrifts dâhil edilir.
--timeout <seconds> Adım başına zaman aşımı. Varsayılan değer 1800.
--yes Onay istemlerini atlayın (örneğin sürüm düşürme onayı).
--acknowledge-clawhub-risk Güncelleme sonrası plugin eşitlemesinin, etkileşimli bir istem olmadan topluluk ClawHub güven uyarılarını aşarak devam etmesine izin verin. Bu seçenek olmadan, OpenClaw istem gösteremediğinde riskli topluluk sürümleri atlanır ve değiştirilmeden bırakılır. Resmî ClawHub paketleri ve paketle birlikte gelen plugin kaynakları bu istemi atlar.

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

update status

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

bash
openclaw update statusopenclaw update status --jsonopenclaw update status --timeout 10
Bayrak Varsayılan Açıklama
--json false Makine tarafından okunabilir durum JSON verisini yazdırın.
--timeout <seconds> 3 Denetimler için zaman aşımı.

Extended-stable paket yüklemelerinde durum, ön plandaki güncellemeyle 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ştirildiği hâlde sonraki onarım çalışmaları düzgün şekilde tamamlanmadıysa 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.

bash
openclaw update repairopenclaw update repair --channel betaopenclaw update repair --acknowledge-clawhub-riskopenclaw update repair --json
Bayrak Açıklama
--channel <stable|extended-stable|beta|dev> Onarımdan önce çekirdek güncelleme kanalını kalıcı hâle getirin. Extended-stable için yalın/varsayılan veya latest amacını izleyen uygun resmî npm plugin'leri, yüklü kesin çekirdek sürümünü hedefler. Extended-stable onarımı, yapılandırma değiştirilmeden Git çalışma kopyalarında reddedilir.
--json Makine tarafından okunabilir sonlandırma JSON verisini yazdırın.
--timeout <seconds> Onarım adımları için zaman aşımı. Varsayılan değer 1800.
--yes Onay istemlerini atlayın.
--acknowledge-clawhub-risk openclaw update üzerindekiyle aynı davranış.
--no-restart Tutarlılık için kabul edilir; onarım Gateway'i hiçbir zaman yeniden başlatmaz.

update repair, openclaw doctor --fix komutunu ç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ınsamış 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çilmesi, bir tane oluşturmayı önerir.

Bayrak Varsayılan Açıklama
--timeout <seconds> 1800 Her güncelleme adımı için zaman aşımı.

İşleyişi

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

  • dev -> bir git çalışma kopyası 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'yi 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 bu kesin 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 eskiyse latest değerine geri döner.

Yeniden başlatma devri

Gateway çekirdeğinin 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 denetimli git çalışma kopyası güncellemeleri, paket ağacını değiştirmek veya canlı Gateway süreci içinde dist/ 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 komutunu Gateway süreç 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çimleri, update.checkOnStart etkinleştirildiğinde salt okunur başlangıç ve 24 saatlik güncelleme ipuçları alır. Bu kontroller hiçbir zaman güncelleme uygulamaz, devir başlatmaz, Gateway'i yeniden başlatmaz, kararlı gecikme/değişken gecikme 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 çalışma kopyası güncellemeleri, paket ağacını değiştirmeden veya çalışma kopyası/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. bildiriminde bulunmadan ö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 çalışma kopyası güncellemeleri ise yeniden derlemeden sonra Gateway durumunu ve hizmet hazır olma durumunu 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'u çalıştırabiliyorsa ve hizmetin güncellenen pakete ait olduğu kanıtlanmışsa, yeniden başlatmanın etkin olduğu 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'te güncelleme sonrası kontrol ayrıca LaunchAgent'ın etkin profil için yüklendiğini/çalıştığını ve yapılandırılmış geri döngü bağlantı noktasının sağlıklı olduğunu doğrular. Plist kuruluysa ancak launchd bunu denetlemiyorsa OpenClaw LaunchAgent'ı otomatik olarak yeniden önyükler ve durum/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 başlatılan Gateway'i hemen kickstart -k etmez). Gateway yine de sağlıklı duruma gelmezse komut sıfır olmayan bir kodla çıkar ve yeniden başlatma günlüğü yolunun yanı sıra yeniden başlatma, yeniden kurma ve paket geri alma talimatlarını yazdırır.

Yeniden başlatma çalıştırılamazsa komut, elle openclaw gateway restart ipucuyla 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; bu nedenle çalışan Gateway siz elle yeniden başlatana kadar eski kodu kullanmaya devam eder.

Kontrol düzlemi yanıt biçimi

update.run, bir paket yöneticisi kurulumunda veya denetlenen git çalışma kopyasında Gateway kontrol düzlemi üzerinden çalıştığında işleyici, devir başlatmayı 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, yönetilen hizmet devrini oluşturdu ve ayrılmış yardımcının canlı hizmet işleminin 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 ortamdaki systemd işlem işaretçilerini değil, OPENCLAW_SYSTEMD_UNIT birim kimliğini gerektirir). Yanıt, Gateway'in 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 durum kontrolleri tamamlandıktan sonra aynı yeniden başlatma işaretçisini günceller. Devir sırasında işaretçi, başarı devamı olmadan stats.reason: "restart-health-pending" taşıyabilir; yeniden başlatılan Gateway bunu yoklar ve devamı yalnızca CLI hizmet durumunu doğruladıktan ve işaretçiyi nihai ok sonucuyla yeniden yazdıktan sonra tetikler. openclaw status ve openclaw status --all, bu işaretçi beklemedeyken veya başarısız olduğunda bir Update restart satırı gösterir; update.status ise yenileyerek en son işaretçiyi döndürür.

Git çalışma kopyası akışı

Kanal seçimi

  • stable: en son beta olmayan etiketi çalışma kopyasına alır, ardından derleme ve doctor işlemlerini ç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 öğesini çalışma kopyasına alır, ardından getirip yeniden temellendirir.
  • extended-stable: Git çalışma kopyaları için desteklenmez; çalışma kopyasında değişiklik yapılmaz.

Güncelleme adımları

  • Temiz çalışma ağacını doğrula

    Kaydedilmemiş değişiklik bulunmamasını gerektirir.

  • Kanalı değiştir

    Seçilen kanala (etiket veya dal) geçer.

  • Üst kaynaktan getir

    Yalnızca geliştirme.

  • Ön kontrol derlemesi (yalnızca geliştirme)

    TypeScript derlemesini geçici bir çalışma ağacında çalıştırır. Uç başarısız olursa derlenebilen en yeni işlemi bulmak için en fazla 10 işlem geriye gider. Bu ön kontrol sırasında lint'i de çalıştırmak için OPENCLAW_UPDATE_PREFLIGHT_LINT=1 ayarlayın; kullanıcı güncelleme makineleri genellikle CI çalıştırıcılarından daha küçük olduğundan lint, kaynakları kısıtlanmış seri modda çalışır.

  • Yeniden temellendir

    Seçilen işlemin üzerine yeniden temellendirir (yalnızca geliştirme).

  • Bağımlılıkları kur

    Deponun paket yöneticisini kullanır. pnpm çalışma kopyalarında güncelleyici, pnpm çalışma alanı içinde npm run build çalıştırmak yerine gerektiğinde pnpm önyüklemesini yapar (önce corepack, ardından geçici bir npm install pnpm@11 geri dönüşü aracılığıyla). pnpm önyüklemesi yine de başarısız olursa güncelleyici, çalışma kopyasında npm run build denemek yerine paket yöneticisine özgü bir hatayla erkenden durur.

  • Control UI'ı derle

    Gateway'i ve Control UI'ı derler.

  • Doctor'ı çalıştır

    openclaw doctor, son güvenli güncelleme kontrolü olarak çalışır.

  • Pluginleri eşitle

    Pluginleri etkin kanalla eşitler. Geliştirme, paketle gelen pluginleri; kararlı ve beta ise npm'i kullanır. İzlenen plugin kurulumlarını günceller.

    • Plugin eşitleme ayrıntıları

    Beta kanalında, varsayılan/en son çizgiyi izleyen kayıtlı npm ve ClawHub plugin kurulumları önce bir plugin @beta sürümünü dener. Pluginin beta sürümü yoksa OpenClaw kayıtlı varsayılan/en son belirtime geri döner ve bir uyarı bildirir. OpenClaw, npm pluginleri için beta paketi mevcut olduğu hâlde kurulum doğrulamasında başarısız olduğunda da geri döner. Bu geri dönüş uyarıları çekirdek güncellemesini başarısız kılmaz. 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 pluginlerini tam olarak 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ında openclaw update, paket yöneticisini çağırmadan önce hedef paket sürümünü çözümler. npm genel kurulumları aşamalı kurulum kullanır: OpenClaw yeni paketi geçici bir npm önekine kurar, aday paketin preinstall sırasında ana makinenin Node sürümünü doğrulamasına izin verir ve paketlenmiş dist envanterini burada 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ş olarak kalır. OpenClaw ardından temiz paket ağacını gerçek genel ö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 genel paket kurulumunu yeniler, ardından plugin eşitlemesini, çekirdek komut tamamlama yenilemesini ve yeniden başlatma işlemlerini ç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.

    İlgili

    Was this useful?
    On this page

    On this page