OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Geçiş kılavuzu

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

Birlikte sunulan geçiş sağlayıcıları; talimatları, MCP sunucularını, Skills'i, model yapılandırmasını ve (isteğe bağlı olarak) API anahtarlarını OpenClaw'a aktarır. Planlar herhangi bir değişiklikten önce önizlenir, raporlarda gizli bilgiler maskelenir ve uygulama işlemi doğrulanmış bir yedekle güvence altına alınır.

Claude'dan geçiş

CLAUDE.md, MCP sunucuları, Skills 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'i ve desteklenen .env anahtarlarını içe aktarın.

CLI giriş noktası openclaw migrate komutudur. İlk katılım, bilinen bir kaynak algıladığında geçiş seçeneği de sunabilir (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 tüm 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 ve istemler.

Geçiş adımları

  • Gateway'i durdurun ve yedekleyin

    Kopyalama sırasında dosyaların değişmemesi için eski makinede Gateway'i durdurun, ardından arşivleyin:

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

    Birden fazla profil kullanıyorsanız (örneğin ~/.openclaw-work), her birini ayrı ayrı arşivleyin.

  • 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.

  • 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, ardından arşivden çıkarın:

    bash
    cd ~tar -xzf openclaw-state.tgz

    Gizli dizinlerin dahil edildiğini ve dosya sahipliğinin Gateway'i çalıştıracak kullanıcıyla eşleştiğini doğrulayın.

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

    Yapılandırma geçişlerini uygulamak ve hizmetleri onarmak için yeni makinede Doctor komutunu çalıştırın:

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • Telegram veya Discord varsayılan ortam değişkeni geri dönüşünü (TELEGRAM_BOT_TOKEN veya DISCORD_BOT_TOKEN) kullanıyorsa, taşınan durum dizinindeki .env dosyasının gizli değerleri yazdırmadan bu anahtarları içerdiğini doğrulayın:

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    openclaw doctor, etkinleştirilmiş varsayılan bir Telegram veya Discord hesabında yapılandırılmış bir belirteç bulunmadığında ve eşleşen ortam değişkeni Doctor işlemi tarafından kullanılamadığında da uyarır.

    Yaygın sorunlar

    Profil veya durum dizini uyuşmazlığı

    Eski Gateway --profile veya OPENCLAW_STATE_DIR kullandığı hâlde 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.

    Yalnızca openclaw.json dosyasını kopyalama

    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ı durumları ise credentials/ altında bulunur. Her zaman durum dizininin tamamını taşıyın.

    İzinler ve sahiplik

    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.

    Uzak mod

    Kullanıcı arayüzünüz uzak bir Gateway'e yöneliyorsa 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 bölümüne bakın.

    Yedeklerdeki gizli bilgiler

    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 çıkma şüpheniz varsa 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 diskteki 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

    Was this useful?
    On this page

    On this page