Güncelleniyor

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 betaopenclaw update --channel devopenclaw update --dry-run   # preview without applying

openclaw update, --verbose kabul etmez. Güncelleme tanılama bilgileri 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 için openclaw update status --json kullanın. Kurucunun kendi --verbose bayrağı vardır, ancak bu bayrak openclaw update parçası değildir.

--channel beta betayı 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 bir paket güncellemesi için ham npm beta dist-tag'ini istiyorsanız --tag beta kullanın.

Kalıcı, hareketli bir GitHub main checkout'u için --channel dev kullanın. Paket güncellemeleri için --tag main, tek bir çalıştırma için github:openclaw/openclaw#main ile eşleşir ve GitHub/git kaynak tanımları, aşamalı npm kurulumundan önce geçici bir tarball içine paketlenir.

Yönetilen Plugin'ler için beta kanalı geri dönüşü bir uyarıdır: Bir Plugin betası mevcut olmadığından, bir Plugin kayıtlı varsayılan/en son sürümünü kullanırken çekirdek güncelleme yine de başarılı olabilir.

Kanal anlamları için Geliştirme kanalları sayfasına bakın.

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

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

# npm package install -> editable git checkoutopenclaw update --channel dev # git checkout -> npm package installopenclaw update --channel stable

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

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

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

Yönetilen Gateway hizmetine sahip paket kurulumlarında openclaw update, bu hizmetin kullandığı paket kökünü hedefler. Kabuk openclaw komutu farklı bir kurulumdan geliyorsa, güncelleyici her iki kökü ve yönetilen hizmet Node yolunu yazdırır. Paket güncellemesi, hizmet kökünün sahibi olan paket yöneticisini kullanır ve paketi değiştirmeden önce yönetilen hizmet Node'unu hedef sürüm motoruna göre kontrol eder.

Alternatif: kurucuyu yeniden çalıştırma

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

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

openclaw update, npm paket kurulumu aşamasından sonra başarısız olursa kurucuyu yeniden çalıştırın. Kurucu 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 hizmetiyle koordine edebilir. Denetimli bir kurulumu manuel güncelliyorsanız, paket yöneticisi başlamadan önce yönetilen Gateway'i durdurun. Paket yöneticileri dosyaları yerinde değiştirir ve çalışan bir Gateway aksi halde paket ağacı geçici olarak yarı değiştirilmişken çekirdek veya Plugin dosyalarını yüklemeye çalışabilir. Paket yöneticisi bittikten sonra Gateway'i yeniden başlatın, böylece hizmet yeni kurulumu alır.

Root'a ait Linux sistem genelinde bir kurulum için, openclaw update EACCES ile başarısız olursa ve sistem npm ile kurtarırsanız, manuel paket değiştirme boyunca Gateway'i durdurulmuş tutun. Normalde o Gateway için kullandığınız aynı openclaw profil bayraklarını veya ortamı kullanın. /usr/bin/npm yerine ana makinenizde root'a ait global prefix'in sahibi olan sistem npm'ini kullanın:

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

Ardından hizmeti 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, hedefi önce geçici bir npm prefix'ine kurar, paketlenmiş dist envanterini doğrular, ardından temiz paket ağacını gerçek global prefix'e geçirir. 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 ana makinelerde yardımcı olurken, geri dönüş de başarısız olursa özgün hatayı görünür tutar.

OpenClaw tarafından yönetilen npm güncelleme ve Plugin güncelleme komutları, alt npm işlemi için npm min-release-age karantinasını da temizler. npm bu politikayı türetilmiş bir before kesme noktası olarak bildirebilir; ikisi de genel tedarik zinciri karantina politikaları için kullanışlıdır, ancak açık bir OpenClaw güncellemesi "seçilen OpenClaw sürümünü şimdi kur" anlamına gelir.

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. update.checkOnStart ayrıca devre dışı bırakılmadıkça başlangıç güncelleme ipuçları yine de çalışabilir.

Canlı Gateway kontrol düzlemi işleyicisi üzerinden istenen paket yöneticisi güncellemeleri, çalışan Gateway işleminin içindeki paket ağacını değiştirmez. Yönetilen hizmet kurulumlarında Gateway ayrık bir devir işlemi 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 kurulmuş ama yüklenmemiş bir macOS LaunchAgent'ı kurtarmasına izin verir. Gateway bu devri güvenli şekilde yapamazsa, update.run paket yöneticisini işlem içinde çalıştırmak yerine güvenli bir kabuk komutu bildirir.

Güncellemeden sonra

openclaw doctor

openclaw gateway restart

openclaw health

Geri alma

Bir sürümü sabitleme (npm)

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

Bir commit'i 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 checkout'larında openclaw update --channel dev için güncelleyici gerektiğinde pnpm önyüklemesini otomatik yapar. Bir pnpm/corepack önyükleme hatası görürseniz, pnpm'i manuel kurun (veya corepack'i yeniden etkinleştirin) ve güncellemeyi yeniden çalıştırın.
• Kontrol edin: Sorun giderme
• Discord'da sorun: https://discord.gg/clawd

İlgili

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