Güncelleme

OpenClaw'u güncel tutun.

Docker, Podman ve Kubernetes imaj değişimleri için Konteyner imajlarını yükseltme bölümüne bakın. Gateway, hazır duruma geçmeden önce başlangıç açısından güvenli yükseltme işlemlerini çalıştırır ve bağlanan durumun elle onarılması gerekiyorsa çıkar.

Önerilen: openclaw update

Kurulum türünüzü (npm veya git) algılar, en son sürümü getirir, openclaw doctor komutunu çalıştırır ve Gateway'i yeniden başlatır.

openclaw update

Kanalları değiştirin veya belirli bir sürümü hedefleyin:

openclaw update --channel betaopenclaw update --channel extended-stableopenclaw update --channel devopenclaw update --dry-run   # uygulamadan önizle

openclaw update komutunda --verbose bayrağı yoktur (yükleyicide vardır). Tanılama için planlanan işlemleri önizlemek üzere --dry-run, yapılandırılmış sonuçlar için --json veya kanal ve kullanılabilirlik durumunu incelemek üzere openclaw update status --json kullanın.

--channel beta, beta npm dist-tag'ini tercih eder; ancak beta etiketi yoksa veya sürümü en son kararlı sürümden eskiyse stable/latest sürümüne geri döner. Bunun yerine ham npm beta dist-tag'ine sabitlenmiş tek seferlik paket güncellemesi için --tag beta kullanın.

--channel extended-stable yalnızca paket kurulumları içindir ve kurulum yalnızca ön planda gerçekleşmeye devam eder. OpenClaw, herkese açık npm extended-stable seçicisini okur, seçilen tam paketi doğrular ve tam olarak bu sürümü kurar. Eksik veya tutarsız kayıt defteri verileri güvenli biçimde başarısız olur; hiçbir zaman latest sürümüne geri dönmez. Seçilen sürüm kurulu sürümden eskiyse normal sürüm düşürme onayı yine geçerlidir. CLI, başarılı bir çekirdek güncellemesinden sonra kanalı kalıcılaştırır; doğrudan npm install -g openclaw@extended-stable çalıştırılması update.channel değerini güncellemez. Çekirdek değişiminden sonra, yalın/varsayılan veya latest amacı taşıyan uygun resmî npm Plugin'leri tam olarak bu çekirdek sürümüne yakınsar. Tam sürüme sabitlemeler ve açıkça belirtilen latest dışı etiketler, üçüncü taraf Plugin'leri ve npm dışı kaynaklar değişmeden kalır. Güncel OpenClaw sürümleriyle oluşturulan katalog kurulumları bu varsayılan amacı korur. Yalnızca tam bir sürüm içeren eski kayıtlar sabitlenmiş olarak kalır; çünkü OpenClaw eski bir otomatik sabitlemeyi kullanıcı sabitlemesinden güvenle ayırt edemez. İlgili Plugin'i yeniden tam çekirdek sürümü izlemeye dahil etmek için extended-stable kanalında bir kez openclaw plugins update @openclaw/name komutunu çalıştırın.

--channel dev, kalıcı ve hareketli bir GitHub main çalışma kopyası sağlar. Tek seferlik paket güncellemesinde --tag main, github:openclaw/openclaw#main paket belirtimine eşlenir ve hedef paket yöneticisi (npm/pnpm/bun) üzerinden doğrudan kurulur.

Yönetilen Plugin'lerde eksik bir beta sürümü hata değil, uyarıdır: bir Plugin kayıtlı varsayılan/latest sürümüne geri dönerken çekirdek güncellemesi yine de başarılı olabilir.

Kanal semantiği için Sürüm kanalları bölümüne bakın.

npm ve git kurulumları arasında geçiş yapma

Kurulum türünü değiştirmek için kanalları kullanın. Güncelleyici; durumunuzu, yapılandırmanızı, kimlik bilgilerinizi ve çalışma alanınızı ~/.openclaw içinde korur; yalnızca CLI ve Gateway'in hangi OpenClaw kod kurulumunu kullandığını değiştirir.

# npm paket kurulumu -> düzenlenebilir git çalışma kopyasıopenclaw update --channel dev # git çalışma kopyası -> npm paket kurulumuopenclaw update --channel stable

Önce kurulum modu geçişini önizleyin:

openclaw update --channel dev --dry-runopenclaw update --channel stable --dry-run

dev, bir git çalışma kopyasının bulunmasını sağlar, bunu derler ve global CLI'ı bu çalışma kopyasından kurar. stable, extended-stable ve beta kanalları paket kurulumlarını kullanır. Extended-stable, bir git çalışma kopyasında herhangi bir değişiklik veya dönüştürme yapılmadan reddedilir. Gateway zaten kuruluysa openclaw update, --no-restart iletmediğiniz sürece hizmet meta verilerini yeniler ve hizmeti yeniden başlatır.

Yönetilen bir Gateway hizmetine sahip paket kurulumlarında openclaw update, bu hizmetin kullandığı paket kökünü hedefler. Kabuktaki openclaw komutu farklı bir kurulumdan geliyorsa güncelleyici her iki kökü ve yönetilen hizmetin Node yolunu yazdırır; paketi değiştirmeden önce bu Node sürümünü hedef sürümün engines.node gereksinimine göre denetler.

Alternatif: yükleyiciyi yeniden çalıştırma

curl -fsSL https://openclaw.ai/install.sh | bash

İlk katılımı atlamak için --no-onboard ekleyin. Belirli bir kurulum türünü zorlamak için --install-method git --no-onboard veya --install-method npm --no-onboard iletin.

npm paket kurulumu aşamasından sonra openclaw update başarısız olursa bunun yerine yükleyiciyi yeniden çalıştırın. Yükleyici güncelleyiciyi çağırmaz; global paket kurulumunu doğrudan çalıştırır ve kısmen güncellenmiş bir npm kurulumunu kurtarabilir.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

Kurtarma işlemini --version ile belirli bir sürüme veya dist-tag'e sabitleyin:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version <version-or-dist-tag>

Alternatif: elle npm, pnpm veya bun kullanma

npm i -g openclaw@latest

Denetimli kurulumlarda openclaw update komutunu tercih edin: Paket değişimini çalışan Gateway hizmetiyle koordine edebilir. Denetimli bir kurulumu elle güncelliyorsanız önce yönetilen Gateway'i durdurun. Paket yöneticileri dosyaları yerinde değiştirir; aksi hâlde çalışan bir Gateway, değişim sırasında çekirdek veya Plugin dosyalarını yüklemeyi deneyebilir. Paket yöneticisi tamamlandıktan sonra yeni kurulumu kullanması için Gateway'i yeniden başlatın.

Kök kullanıcıya ait, Linux sistem genelindeki bir kurulumda openclaw update EACCES hatasıyla başarısız olursa elle değiştirme sırasında Gateway'i durdurulmuş durumda tutarak sistem npm'iyle kurtarma yapın. İlgili Gateway için normalde kullandığınız profil bayraklarını/ortamını kullanın. /usr/bin/npm yolunu, ana makinenizde kök kullanıcıya ait global ön ekin sahibi olan sistem npm'iyle değiştirin:

openclaw gateway stopsudo /usr/bin/npm i -g openclaw@latestopenclaw gateway install --forceopenclaw gateway restart

Ardından doğrulayın:

openclaw --versioncurl -fsS http://127.0.0.1:18789/readyzopenclaw plugins list --jsonopenclaw gateway status --deep --jsonopenclaw doctor --lint --json

openclaw update global bir npm kurulumunu yönettiğinde önce hedefi geçici bir npm ön ekine kurar, paketlenmiş dist envanterini doğrular, ardından temiz paket ağacını gerçek global ön eke geçirir; böylece npm'in yeni paketi eskisinden kalan bayat dosyaların üzerine bindirmesini önler. Kurulum komutu başarısız olursa OpenClaw --omit=optional ile bir kez daha dener; bu, yerel isteğe bağlı bağımlılıkların derlenemediği ana makinelerde yardımcı olur.

OpenClaw tarafından yönetilen npm güncelleme ve Plugin güncelleme komutları, alt npm işlemi için npm'in min-release-age tedarik zinciri karantinasını (veya eski before yapılandırma anahtarını) da temizler. Bu politika genel koruma için vardır; ancak açık bir OpenClaw güncellemesi, "seçilen sürümü şimdi kur" anlamına gelir.

pnpm add -g openclaw@latest

bun add -g openclaw@latest

İleri düzey npm kurulum konuları

ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp

Otomatik güncelleyici

Varsayılan olarak kapalıdır. ~/.openclaw/openclaw.json içinde etkinleştirin:

{  update: {    channel: "stable",    auto: {      enabled: true,      stableDelayHours: 6,      stableJitterHours: 12,      betaCheckIntervalHours: 1,    },  },}

Gateway ayrıca başlangıçta bir güncelleme ipucu günlüğe kaydeder (update.checkOnStart: false ile devre dışı bırakın). Saklanan extended-stable seçimleri bu salt okunur ipucu yolunu ve mevcut 24 saatlik ipucu aralığını kullanır; ancak otomatik kurulumu, devri, yeniden başlatmayı, kararlı sürüm gecikmesini/sapmasını veya beta yoklamasını hiçbir zaman başlatmaz. Sürüm düşürme veya olay kurtarma için update.auto.enabled yapılandırılmış olsa bile otomatik uygulamaları engellemek üzere Gateway ortamında OPENCLAW_NO_AUTO_UPDATE=1 ayarlayın. update.checkOnStart da devre dışı bırakılmadığı sürece başlangıç güncelleme ipuçları yine çalışabilir.

Canlı Gateway denetim düzlemi (update.run) üzerinden istenen paket yöneticisi güncellemeleri, çalışan Gateway işlemi içindeki paket ağacını değiştirmez. Yönetilen hizmet kurulumlarında Gateway ayrık bir devir başlatır, çıkar ve normal openclaw update --yes --json CLI yolunun hizmeti durdurmasına, paketi değiştirmesine, hizmet meta verilerini yenilemesine, yeniden başlatmasına, Gateway sürümünü ve erişilebilirliğini doğrulamasına ve mümkün olduğunda kurulu ancak yüklenmemiş bir macOS LaunchAgent'ı kurtarmasına izin verir. Gateway bu devri güvenle yapamazsa update.run, paket yöneticisini işlem içinde çalıştırmak yerine güvenli bir kabuk komutu bildirir.

Control UI kenar çubuğundaki güncelleme kartı aynı update.run akışını başlatır. İmzalı macOS uygulamasında kart önce Sparkle aracılığıyla uygulamayı günceller; uygulama yeniden başlatıldıktan sonra yönetilen yerel Gateway'i eşleşen sürüme getirir.

Güncellemeden sonra

openclaw doctor

openclaw gateway restart

openclaw health

Geri alma

Bir sürüme sabitleme (npm)

npm i -g openclaw@<version>openclaw doctoropenclaw gateway restart

Bir commit'e sabitleme (kaynak)

git fetch origingit checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"pnpm install && pnpm buildopenclaw gateway restart

En son sürüme dönmek için: git checkout main && git pull.

Takılırsanız

• openclaw doctor komutunu yeniden çalıştırın ve çıktıyı dikkatle okuyun.
• Kaynak çalışma kopyalarında openclaw update --channel dev kullanıldığında güncelleyici, gerektiğinde pnpm için önyüklemeyi otomatik olarak yapar. Bir pnpm/corepack önyükleme hatası görürseniz pnpm'i elle kurun (veya corepack'i yeniden etkinleştirin) ve güncellemeyi yeniden çalıştırın.
• Şuraya bakın: Sorun giderme
• Discord'da sorun: https://discord.gg/clawd

İlgili

• Kuruluma genel bakış: tüm kurulum yöntemleri.
• Doctor: güncellemelerden sonraki sistem durumu kontrolleri.
• Geçiş: ana sürümler için geçiş kılavuzları.