Ana içeriğe atla

​
Güncelleme

OpenClaw hızlı ilerliyor (1.0 öncesi). Güncellemeleri altyapı dağıtımı gibi ele alın: güncelle → kontrolleri çalıştır → yeniden başlat (veya yeniden başlatan openclaw update kullan) → doğrula.

​
Önerilen: web sitesi yükleyicisini yeniden çalıştırın (yerinde yükseltme)

Tercih edilen güncelleme yolu, web sitesindeki yükleyiciyi yeniden çalıştırmaktır. Mevcut kurulumları algılar, yerinde yükseltir ve gerektiğinde openclaw doctor çalıştırır. 
curl -fsSL https://openclaw.ai/install.sh | bash
Notlar:
  • Karşılama sihirbazının tekrar çalışmasını istemiyorsanız --no-onboard ekleyin.
  • Kaynaktan kurulumlar için şunu kullanın: 
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
    Yükleyici, depo temizse yalnızca git pull --rebase yapar.
  • Global kurulumlar için betik, perde arkasında npm install -g openclaw@latest kullanır.
  • Eski not: clawdbot bir uyumluluk katmanı olarak kullanılabilir durumda kalır.

​
Güncellemeden önce

  • Nasıl kurduğunuzu bilin: global (npm/pnpm) vs kaynaktan (git clone).
  • Gateway’inizin nasıl çalıştığını bilin: ön planda terminal vs denetimli servis (launchd/systemd).
  • Snapshot your tailoring:
    • Yapılandırma: ~/.openclaw/openclaw.json
    • Kimlik bilgileri: ~/.openclaw/credentials/
    • Çalışma alanı: ~/.openclaw/workspace

​
Güncelleme (global kurulum)

Global kurulum (birini seçin): 
npm i -g openclaw@latest

pnpm add -g openclaw@latest
Gateway çalışma zamanı için Bun’u önermiyoruz (WhatsApp/Telegram hataları). Güncelleme kanallarını değiştirmek için (git + npm kurulumları): 
openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable
Tek seferlik bir kurulum etiketi/sürümü için --tag <dist-tag|version> kullanın. Kanal anlamları ve sürüm notları için Geliştirme kanalları sayfasına bakın. Not: npm kurulumlarında gateway, başlangıçta bir güncelleme ipucu günlüğe yazar (mevcut kanal etiketini kontrol eder). update.checkOnStart: false ile devre dışı bırakın. Ardından: 
openclaw doctor
openclaw gateway restart
openclaw health
Notlar:
  • Gateway’iniz bir servis olarak çalışıyorsa, PID’leri öldürmek yerine openclaw gateway restart tercih edilir.
  • Belirli bir sürüme sabitlenmişseniz, aşağıdaki “Geri alma / sabitleme” bölümüne bakın.

​
Güncelleme (openclaw update)

Kaynaktan kurulumlar (git checkout) için tercih edilen: 
openclaw update
Güvenli sayılabilecek bir güncelleme akışı çalıştırır:
  • Temiz bir çalışma ağacı gerektirir.
  • Seçilen kanala (etiket veya dal) geçer.
  • Yapılandırılmış upstream’e (dev kanalı) karşı getirir + rebase eder.
  • Bağımlılıkları kurar, derler, Control UI’yi derler ve openclaw doctor çalıştırır.
  • Varsayılan olarak gateway’i yeniden başlatır (atlamak için --no-restart kullanın).
npm/pnpm ile kurduysanız (git meta verisi yok), openclaw update paket yöneticiniz üzerinden güncellemeyi dener. Kurulumu algılayamazsa, bunun yerine “Güncelleme (global kurulum)”u kullanın.

​
Güncelleme (Control UI / RPC)

Control UI’de Güncelle & Yeniden Başlat (RPC: update.run) bulunur. Şunları yapar:
  1. openclaw update ile aynı kaynak-güncelleme akışını çalıştırır (yalnızca git checkout).
  2. Yapılandırılmış bir raporla (stdout/stderr kuyruğu) bir yeniden başlatma işareti yazar.
  3. Gateway’i yeniden başlatır ve raporla son etkin oturumu ping’ler.
Rebase başarısız olursa, gateway güncellemeyi uygulamadan iptal eder ve yeniden başlatır.

​
Güncelleme (kaynaktan)

Depo checkout’undan: Tercih edilen: 
openclaw update
Manuel (yaklaşık eşdeğer): 
git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health
Notlar:
  • Paketlenmiş openclaw ikilisini (openclaw.mjs) çalıştırdığınızda veya Node ile dist/ çalıştırdığınızda pnpm build önemlidir.
  • Global kurulum olmadan bir depo checkout’undan çalışıyorsanız, CLI komutları için pnpm openclaw ... kullanın.
  • Doğrudan TypeScript’ten (pnpm openclaw ...) çalıştırıyorsanız, yeniden derleme genellikle gerekmez; ancak yapılandırma geçişleri yine de geçerlidir → doctor çalıştırın.
  • Global ve git kurulumları arasında geçiş yapmak kolaydır: diğer türü kurun, ardından gateway servis giriş noktası mevcut kuruluma yeniden yazılsın diye openclaw doctor çalıştırın.

​
Her Zaman Çalıştırın: openclaw doctor

Doctor, “güvenli güncelleme” komutudur. Bilinçli olarak sıkıcıdır: onar + taşı + uyar. Not: kaynaktan kurulum (git checkout) üzerindeyseniz, openclaw doctor önce openclaw update çalıştırmayı önerecektir. Tipik olarak yaptıkları:
  • Kullanımdan kaldırılmış yapılandırma anahtarlarını / eski yapılandırma dosyası konumlarını taşır.
  • DM politikalarını denetler ve riskli “açık” ayarlarda uyarır.
  • Gateway sağlığını kontrol eder ve yeniden başlatmayı önerebilir.
  • Eski gateway servislerini (launchd/systemd; eski schtasks) mevcut OpenClaw servislerine algılar ve taşır.
  • Linux’ta systemd kullanıcı kalıcılığını sağlar (Gateway’in oturum kapatmada hayatta kalması için).
Ayrıntılar: Doctor

​
Gateway’i başlat / durdur / yeniden başlat

CLI (işletim sisteminden bağımsız çalışır): 
openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow
Denetim altındaysanız:
  • macOS launchd (uygulama paketli LaunchAgent): launchctl kickstart -k gui/$UID/bot.molt.gateway (bot.molt.<profile> kullanın; eski com.openclaw.* hâlâ çalışır)
  • Linux systemd kullanıcı servisi: systemctl --user restart openclaw-gateway[-<profile>].service
  • Windows (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
    • launchctl/systemctl yalnızca servis kuruluysa çalışır; aksi halde openclaw gateway install çalıştırın.
Çalıştırma kılavuzu + kesin servis etiketleri: Gateway runbook

​
Geri alma / sabitleme (bir şeyler bozulduğunda)

​
Sabitle (global kurulum)

Bilinen, sorunsuz bir sürümü kurun (<version> yerine son çalışanı koyun): 
npm i -g openclaw@<version>

pnpm add -g openclaw@<version>
İpucu: yayımlanan mevcut sürümü görmek için npm view openclaw version çalıştırın. Ardından yeniden başlatın + doctor’ı tekrar çalıştırın: 
openclaw doctor
openclaw gateway restart

​
Pin (source) by date

Bir tarihten bir commit seçin (örnek: “2026-01-01 itibarıyla main’in durumu”): 
git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
Ardından bağımlılıkları yeniden kurun + yeniden başlatın: 
pnpm install
pnpm build
openclaw gateway restart
Daha sonra tekrar en güncele dönmek isterseniz: 
git checkout main
git pull

​
Takılı kaldıysanız