Ana içeriğe atla

​
OpenClaw’ı Yeni Bir Makineye Taşıma

Bu kılavuz, onboarding’i yeniden yapmadan bir OpenClaw gateway’ini yeni bir makineye taşır.

​
Neler Taşınır

Durum dizinini (varsayılan olarak ~/.openclaw/) ve çalışma alanınızı kopyaladığınızda şunları korursunuz:
  • Yapılandırma — openclaw.json ve tüm gateway ayarları
  • Kimlik doğrulama — agent başına auth-profiles.json (API anahtarları + OAuth), ayrıca credentials/ altındaki tüm kanal/sağlayıcı durumu
  • Oturumlar — konuşma geçmişi ve agent durumu
  • Kanal durumu — WhatsApp girişi, Telegram oturumu vb.
  • Çalışma alanı dosyaları — MEMORY.md, USER.md, skills ve istemler
Durum dizini yolunuzu doğrulamak için eski makinede openclaw status çalıştırın. Özel profiller ~/.openclaw-<profile>/ veya OPENCLAW_STATE_DIR ile ayarlanan bir yol kullanır.

​
Geçiş Adımları

1

Gateway’i durdurun ve yedek alın

Eski makinede, dosyalar kopyalama sırasında değişmesin diye gateway’i durdurun, ardından arşivleyin:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
Birden fazla profil kullanıyorsanız (ör. ~/.openclaw-work), her birini ayrı ayrı arşivleyin.
2

OpenClaw’ı yeni makineye kurun

Yeni makinede CLI’yi (ve gerekirse Node’u) Install ile kurun. Onboarding’in yeni bir ~/.openclaw/ oluşturması sorun değildir — bir sonraki adımda üzerine yazacaksınız.
3

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

Arşivi scp, rsync -a veya harici sürücü ile aktarın, sonra çıkarın:
cd ~
tar -xzf openclaw-state.tgz
Gizli dizinlerin dahil edildiğinden ve dosya sahipliğinin gateway’i çalıştıracak kullanıcıyla eşleştiğinden emin olun.
4

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

Yeni makinede, yapılandırma geçişlerini uygulamak ve hizmetleri onarmak için Doctor çalıştırın:
openclaw doctor
openclaw gateway restart
openclaw status

​
Yaygın Hatalar

Eski gateway --profile veya OPENCLAW_STATE_DIR kullanıyorduysa ve yenisi kullanmıyorsa, kanallar oturumu kapatılmış gibi 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.
Tek başına yapılandırma dosyası yeterli değildir. Model kimlik doğrulama profilleri agents/<agentId>/agent/auth-profiles.json altında bulunur, kanal/sağlayıcı durumu ise hâlâ credentials/ altında yaşar. Her zaman tüm durum dizinini taşıyın.
Root 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.
UI’niz uzak bir gateway’e işaret ediyorsa, oturumların ve çalışma alanının sahibi uzak ana bilgisayardır. Yerel dizüstü bilgisayarınızı değil, gateway ana bilgisayarının kendisini taşıyın. Bkz. FAQ.
Durum dizini; kimlik doğrulama profilleri, kanal kimlik bilgileri ve diğer sağlayıcı durumlarını içerir. Yedekleri şifreli saklayın, güvenli olmayan aktarım kanallarından kaçının ve maruz kalmadan şüpheleniyorsanız anahtarları döndürün.

​
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)
  • Dashboard açılıyor ve mevcut oturumları gösteriyor
  • Çalışma alanı dosyaları (hafıza, yapılandırmalar) mevcut