Sürüm kanalları

OpenClaw dört güncelleme kanalıyla sunulur:

• stable: npm dist-tag latest. Çoğu kullanıcı için önerilir.
• extended-stable: npm dist-tag extended-stable. Tamamen yeni, geriden gelen desteklenen ay paket kanalıdır. Yalnızca paket olarak sunulur ve kurulum yalnızca ön planda gerçekleştirilir. Kaydedilmiş bir seçim, update.checkOnStart etkinleştirildiğinde salt okunur güncelleme ipuçları alır, ancak güncellemeleri hiçbir zaman otomatik olarak uygulamaz.
• beta: npm dist-tag beta. beta yoksa veya mevcut kararlı sürümden eskiyse latest değerine geri döner.
• dev: main dalının hareketli ucu (git). Yayımlandığında npm dist-tag dev. main denemeler ve etkin geliştirme içindir; tamamlanmamış özellikler veya geriye dönük uyumsuz değişiklikler içerebilir. Üretim Gateway'leri için çalıştırmayın.

Kararlı derlemeler genellikle önce beta kanalında yayımlanır, burada incelendikten sonra sürüm numarası artırılmadan latest kanalına yükseltilir. Bakımcılar doğrudan latest kanalında da yayımlayabilir. npm kurulumları için doğruluğun kaynağı dist-tag'lerdir.

Kanallar arasında geçiş yapma

openclaw update --channel stableopenclaw update --channel extended-stableopenclaw update --channel betaopenclaw update --channel dev

--channel seçimi yapılandırmadaki update.channel alanında kalıcı hale getirir ve her iki kurulum yolunu da yönetir:

dev git kurulumlarında varsayılan çalışma kopyası ~/openclaw'dir (OPENCLAW_HOME ayarlandığında $OPENCLAW_HOME/openclaw); OPENCLAW_GIT_DIR ile geçersiz kılın.

Tek seferlik sürüm veya etiket hedefleme

Kalıcı kanalı değiştirmeden tek bir güncelleme için belirli bir dist-tag, sürüm veya paket belirtimini hedeflemek üzere --tag kullanın:

# Belirli bir sürümü kuropenclaw update --tag 2026.4.1-beta.1 # Beta dist-tag'inden kur (tek seferliktir, kalıcı olmaz)openclaw update --tag beta # Hareketli GitHub main çalışma kopyasına geç (kalıcı)openclaw update --channel dev # Belirli bir npm paket belirtimini kuropenclaw update --tag openclaw@2026.4.1-beta.1 # Kanalı kalıcı hale getirmeden GitHub main'den bir kez kuropenclaw update --tag main

Notlar:

• --tag yalnızca paket (npm) kurulumlarına uygulanır; git kurulumları bunu yok sayar.
• Etiket kalıcı hale getirilmez; sonraki openclaw update yapılandırılmış kanalı kullanır.
• --tag main, bu tek çalıştırma için npm uyumlu github:openclaw/openclaw#main belirtimine eşlenir. Kalıcı ve hareketli bir main kurulumu için openclaw update --channel dev kullanın (paket kurulumları bir git çalışma kopyasına geçer) veya yükleyicinin git yöntemiyle yeniden kurun: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main. npm kurulum yolu, GitHub/git kaynak hedeflerini doğrudan reddeder ve bunun yerine sizi git yöntemine yönlendirir.
• Sürüm düşürme koruması: hedef sürüm mevcut sürümden eskiyse OpenClaw onay ister (--yes ile atlayın).
• Extended-stable her zaman doğrulanmış tam paket hedefini kullanır. --tag extended-stable için tek seferlik bir diğer ad değildir ve --tag etkin bir extended-stable kanalıyla birlikte kullanılamaz.
• --channel beta, --tag beta değerinden farklıdır: kanal akışı, beta yoksa veya daha eskiyse stable/latest değerine geri dönebilir; --tag beta ise bu tek çalıştırmada her zaman ham beta dist-tag'ini hedefler.

Deneme çalıştırması

openclaw update komutunun değişiklik yapmadan ne gerçekleştireceğini önizleyin:

openclaw update --dry-runopenclaw update --channel beta --dry-runopenclaw update --tag 2026.4.1-beta.1 --dry-runopenclaw update --dry-run --json

Deneme çalıştırması; etkin kanalı, hedef sürümü, planlanan işlemleri ve sürüm düşürme onayı gerekip gerekmediğini bildirir.

Plugin'ler ve kanallar

openclaw update ile kanal değiştirmek Plugin kaynaklarını da eşitler:

• dev, paketle gelen karşılığı bulunan kurulu Plugin'leri yeniden paketle gelen (git çalışma kopyası) kaynaklarına geçirir.
• stable ve beta, npm veya ClawHub üzerinden kurulmuş Plugin paketlerini geri yükler.
• extended-stable, yalın/varsayılan ya da latest amaçlı uygun resmî npm Plugin'lerini kurulu çekirdeğin tam sürümüne çözümler. Çalışma zamanında Plugin @extended-stable etiketlerini sorgulamaz.
• npm ile kurulan Plugin'ler, çekirdek güncellemesi tamamlandıktan sonra güncellenir.

Mevcut durumu denetleme

openclaw update status

Etkin kanalı (bunu belirleyen kaynakla birlikte: yapılandırma, git etiketi, git dalı, kurulu sürüm veya varsayılan), kurulum türünü (git veya paket), mevcut sürümü ve güncelleme kullanılabilirliğini gösterir.

Etiketleme için en iyi uygulamalar

• Git çalışma kopyalarının ulaşmasını istediğiniz sürümleri etiketleyin: kararlı sürüm için vYYYY.M.PATCH, beta için vYYYY.M.PATCH-beta.N. -alpha.N, -rc.N ve -next.N gibi adlandırılmış ön sürüm sonekleri kararlı veya beta hedefleri değildir.
• vYYYY.M.PATCH-1 ve v1.0.1-1 gibi eski sayısal kararlı etiketler, uyumluluk amacıyla hâlâ kararlı git etiketleri olarak tanınır.
• vYYYY.M.PATCH.beta.N (noktayla ayrılmış) da uyumluluk amacıyla tanınır; -beta.N tercih edilir.
• Etiketleri değişmez tutun: bir etiketi hiçbir zaman taşımayın veya yeniden kullanmayın.
• npm kurulumları için doğruluğun kaynağı npm dist-tag'leri olmaya devam eder:
  • latest -> kararlı
  • extended-stable -> geriden gelen desteklenen ay paket sürümü
  • beta -> aday derleme veya önce beta olarak sunulan kararlı derleme
  • dev -> main anlık görüntüsü (isteğe bağlı)

macOS uygulamasının kullanılabilirliği

Beta ve dev derlemeleri bir macOS uygulama sürümü içermeyebilir. Bu sorun değildir:

• Git etiketi ve npm dist-tag'i yine de bağımsız olarak yayımlanabilir.
• Sürüm notlarında veya değişiklik günlüğünde "bu beta için macOS derlemesi yok" ifadesini belirtin.

İlgili

• Güncelleme
• Yükleyicinin iç işleyişi