Güncelleme

OpenClaw'ı güncel tutun.

# Önerilen: openclaw update

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

openclaw update

Kanalları değiştirmek veya belirli bir sürümü hedeflemek için:

openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag main
openclaw update --dry-run   # preview without applying

openclaw update, --verbose kabul etmez. Güncelleme tanılaması için planlanan eylemleri önizlemek üzere --dry-run, yapılandırılmış sonuçlar için --json veya kanal ve kullanılabilirlik durumunu incelemek için openclaw update status --json kullanın. Yükleyicinin kendi --verbose bayrağı vardır, ancak bu bayrak openclaw update parçası değildir.

--channel beta beta'yı tercih eder, ancak beta etiketi eksikse veya en son kararlı sürümden eskiyse çalışma zamanı kararlı/en son sürüme geri döner. Tek seferlik paket güncellemesi için ham npm beta dist-tag'ini istiyorsanız --tag beta kullanın.

Kanal semantiği için Geliştirme kanalları bölümüne bakın.

# npm ve git kurulumları arasında geçiş yapın

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

# npm package install -> editable git checkout
openclaw update --channel dev

# git checkout -> npm package install
openclaw update --channel stable

Kesin kurulum modu geçişini önizlemek için önce --dry-run ile çalıştırın:

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

dev kanalı bir git checkout'u sağlar, onu derler ve global CLI'yi bu checkout'tan kurar. stable ve beta kanalları paket kurulumlarını kullanır. Gateway zaten kuruluysa, openclaw update servis meta verilerini yeniler ve --no-restart geçmediğiniz sürece yeniden başlatır.

# Alternatif: yükleyiciyi yeniden çalıştırın

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

İlk kurulumu atlamak için --no-onboard ekleyin. Yükleyici üzerinden belirli bir kurulum türünü zorlamak için --install-method git --no-onboard veya --install-method npm --no-onboard geçin.

openclaw update, npm paket kurulum aşamasından sonra başarısız olursa yükleyiciyi yeniden çalıştırın. Yükleyici eski 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

Kurtarmayı belirli bir sürüme veya dist-tag'e sabitlemek için --version ekleyin:

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

# Alternatif: manuel npm, pnpm veya bun

npm i -g openclaw@latest

Denetimli kurulumlar için openclaw update tercih edin, çünkü paket değişimini çalışan Gateway servisiyle koordine edebilir. Yönetilen bir Gateway çalışırken manuel güncelleme yaparsanız, paket yöneticisi tamamlandıktan hemen sonra Gateway'i yeniden başlatın; böylece eski süreç, değiştirilmiş paket dosyalarından sunmaya devam etmez.

openclaw update global bir npm kurulumunu yönettiğinde, hedefi önce geçici bir npm prefix'ine kurar, paketlenmiş dist envanterini doğrular, sonra temiz paket ağacını gerçek global prefix'e taşır. Bu, npm'in yeni paketi eski paketten kalan bayat dosyaların üzerine bindirmesini önler. Kurulum komutu başarısız olursa, OpenClaw --omit=optional ile bir kez daha dener. Bu yeniden deneme, yerel isteğe bağlı bağımlılıkların derlenemediği makinelerde yardımcı olurken, yedek de başarısız olursa asıl hatayı görünür tutar.

pnpm add -g openclaw@latest

bun add -g openclaw@latest

# Gelişmiş npm kurulum konuları

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

# Otomatik güncelleyici

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 yazar (update.checkOnStart: false ile devre dışı bırakın). 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. Başlangıç güncelleme ipuçları, update.checkOnStart da devre dışı bırakılmadıkça çalışmaya devam edebilir.

Canlı Gateway kontrol düzlemi işleyicisi üzerinden istenen paket yöneticisi güncellemeleri, paket değişiminden sonra ertelenmeyen, soğuma süresi olmayan bir güncelleme yeniden başlatmasını zorlar. Bu, eski bellek içi sürecin, zaten değiştirilmiş bir paket ağacından parçaları tembel yükleyecek kadar uzun süre ortada kalmasını önler. Shell openclaw update, servisi güncelleme etrafında durdurup yeniden başlatabildiği için denetimli kurulumlarda tercih edilen yol olmaya devam eder.

# Güncellemeden sonra

openclaw doctor

openclaw gateway restart

openclaw health

# Geri alma

# Bir sürüme sabitleyin (npm)

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

# Bir commit'e sabitleyin (kaynak)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw 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 checkout'larında openclaw update --channel dev için güncelleyici gerektiğinde pnpm'i otomatik olarak önyükler. Bir pnpm/corepack önyükleme hatası görürseniz, pnpm'i manuel kurun (veya corepack'i yeniden etkinleştirin) ve güncellemeyi tekrar çalıştırın.
• Kontrol edin: Sorun giderme
• Discord'da sorun: https://discord.gg/clawd

# İlgili

• Kurulum özeti: tüm kurulum yöntemleri.
• Doctor: güncellemelerden sonra sağlık kontrolleri.
• Geçiş: büyük sürüm geçiş kılavuzları.