Skip to main content
OpenClaw üç geçiş yolunu destekler: başka bir aracı sisteminden içe aktarma, mevcut bir kurulumu yeni bir makineye taşıma ve bir Plugin’i yerinde yükseltme.

​
Başka bir aracı sisteminden içe aktarma

Paketle birlikte sunulan geçiş sağlayıcıları; talimatları, MCP sunucularını, Skills’leri, model yapılandırmasını ve (isteğe bağlı) API anahtarlarını OpenClaw’a aktarır. Herhangi bir değişiklik yapılmadan önce planlar önizlenir ve raporlarda gizli bilgiler maskelenir. Bağımsız openclaw migrate doğrulanmış bir yedekle desteklenir; yeni ilk katılım içe aktarmaları ise geri döndürülemez herhangi bir harici etkinleştirmeden önce yapılandırmayı kaydederek, yerel yapıtları yayımlamadan önce hazırlar ve doğrular.

Claude'dan geçiş

CLAUDE.md, MCP sunucuları, Skills’ler ve proje komutları dahil olmak üzere Claude Code ve Claude Desktop durumunu içe aktarın.

Hermes'ten geçiş

Hermes yapılandırmasını, sağlayıcılarını, MCP sunucularını, belleğini, Skills’lerini ve desteklenen .env anahtarlarını içe aktarın.
CLI giriş noktası openclaw migrate şeklindedir. İlk katılım, bilinen bir kaynak algıladığında da geçiş önerebilir (openclaw onboard --flow import).

​
OpenClaw’ı yeni bir makineye taşıma

Şunları korumak için durum dizinini (varsayılan olarak ~/.openclaw/) ve çalışma alanınızı kopyalayın:
  • Yapılandırma — openclaw.json ve tüm Gateway ayarları.
  • Kimlik doğrulama — aracı başına auth-profiles.json (API anahtarları ve OAuth) ile credentials/ altındaki kanal veya sağlayıcı durumları.
  • Oturumlar — konuşma geçmişi ve aracı durumu.
  • Kanal durumu — WhatsApp oturum açma bilgileri, Telegram oturumu ve benzerleri.
  • Çalışma alanı dosyaları — MEMORY.md, USER.md, Skills’ler ve istemler.
Durum dizini yolunuzu doğrulamak için eski makinede openclaw status komutunu çalıştırın. Özel profiller ~/.openclaw-<profile>/ veya OPENCLAW_STATE_DIR aracılığıyla ayarlanan bir yolu kullanır.

​
Geçiş adımları

1

Gateway'i durdurun ve yedekleyin

Eski makinede, dosyaların kopyalama sırasında değişmemesi için Gateway’i durdurun ve ardından arşivleyin:
Birden fazla profil kullanıyorsanız (örneğin ~/.openclaw-work), her birini ayrı ayrı arşivleyin.
2

OpenClaw'ı yeni makineye kurun

Yeni makineye CLI’yi (ve gerekirse Node’u) kurun. İlk katılımın yeni bir ~/.openclaw/ oluşturmasında sakınca yoktur; sonraki adımda bunun üzerine yazacaksınız.
3

Durum dizinini ve çalışma alanını kopyalayın

Arşivi scp, rsync -a veya harici bir sürücü aracılığıyla aktarın ve ardından çıkarın:
Gizli dizinlerin dahil edildiğini ve dosya sahipliğinin Gateway’i çalıştıracak kullanıcıyla eşleştiğini doğrulayın.
4

Doctor'ı çalıştırın ve doğrulayın

Yapılandırma geçişlerini uygulamak ve hizmetleri onarmak için yeni makinede Doctor aracını çalıştırın:
Telegram veya Discord varsayılan ortam değişkeni geri dönüşünü (TELEGRAM_BOT_TOKEN veya DISCORD_BOT_TOKEN) kullanıyorsa, gizli değerleri yazdırmadan, taşınan durum dizinindeki .env dosyasının bu anahtarları içerdiğini doğrulayın:
openclaw doctor, etkinleştirilmiş varsayılan bir Telegram veya Discord hesabında yapılandırılmış bir token bulunmadığında ve eşleşen ortam değişkeni Doctor işlemi tarafından kullanılamadığında da uyarır.

​
Yaygın sorunlar

Eski Gateway --profile veya OPENCLAW_STATE_DIR kullanırken yenisi kullanmıyorsa, kanalların oturumu kapalı görünür ve oturumlar boş olur. Gateway’i taşıdığınız aynı profil veya durum diziniyle başlatın, ardından openclaw doctor komutunu yeniden çalıştırın.
Yapılandırma dosyası tek başına yeterli değildir. Model kimlik doğrulama profilleri agents/<agentId>/agent/auth-profiles.json altında, kanal ve sağlayıcı durumu ise credentials/ altında bulunur. Her zaman tüm durum dizinini taşıyın.
Kök kullanıcı olarak kopyaladıysanız veya kullanıcı değiştirdiyseniz Gateway kimlik bilgilerini okuyamayabilir. Durum dizininin ve çalışma alanının Gateway’i çalıştıran kullanıcıya ait olduğundan emin olun.
Kullanıcı arayüzünüz uzak bir Gateway’e bağlanıyorsa oturumların ve çalışma alanının sahibi uzak ana makinedir. Yerel dizüstü bilgisayarınızı değil, Gateway ana makinesinin kendisini taşıyın. SSS sayfasına bakın.
Durum dizini; kimlik doğrulama profillerini, kanal kimlik bilgilerini ve diğer sağlayıcı durumlarını içerir. Yedekleri şifrelenmiş olarak saklayın, güvenli olmayan aktarım kanallarından kaçının ve açığa çıkmış olabileceğinden şüpheleniyorsanız anahtarları yenileyin.

​
Doğrulama kontrol listesi

Yeni makinede şunları doğrulayın:
  • openclaw status, Gateway’in çalıştığını gösteriyor.
  • Kanallar hâlâ bağlı (yeniden eşleştirme gerekmiyor).
  • Gösterge paneli açılıyor ve mevcut oturumları gösteriyor.
  • Çalışma alanı dosyaları (bellek, yapılandırmalar) mevcut.

​
Bir Plugin’i yerinde yükseltme

Yerinde Plugin yükseltmeleri aynı Plugin kimliğini ve yapılandırma anahtarlarını korur ancak disk üzerindeki durumu geçerli düzene taşıyabilir. Plugin’e özgü yükseltme kılavuzları ilgili kanalların yanında bulunur:
  • Matrix geçişi: şifrelenmiş durum kurtarma sınırları, otomatik anlık görüntü davranışı ve manuel kurtarma komutları.

​
İlgili