Ana içeriğe atla
OpenClaw, Hermes durumunu paketlenmiş bir geçiş sağlayıcısı üzerinden içe aktarır. Sağlayıcı, durumu değiştirmeden önce her şeyi önizler, planlarda ve raporlarda sırları redakte eder ve uygulamadan önce doğrulanmış bir yedek oluşturur.
İçe aktarımlar yeni bir OpenClaw kurulumu gerektirir. Zaten yerel OpenClaw durumunuz varsa önce yapılandırmayı, kimlik bilgilerini, oturumları ve çalışma alanını sıfırlayın ya da planı inceledikten sonra --overwrite ile doğrudan openclaw migrate kullanın.

​
İçe aktarmanın iki yolu

En hızlı yol. Sihirbaz Hermes’i ~/.hermes konumunda algılar ve uygulamadan önce bir önizleme gösterir.
openclaw onboard --flow import
Ya da belirli bir kaynağı gösterin:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Neler içe aktarılır

  • Hermes config.yaml dosyasından varsayılan model seçimi.
  • providers ve custom_providers içinden yapılandırılmış model sağlayıcıları ve özel OpenAI uyumlu uç noktalar.
mcp_servers veya mcp.servers içinden MCP sunucu tanımları.
  • SOUL.md ve AGENTS.md, OpenClaw ajan çalışma alanına kopyalanır.
  • memories/MEMORY.md ve memories/USER.md, üzerlerine yazılmak yerine eşleşen OpenClaw bellek dosyalarına eklenir.
OpenClaw dosya belleği için bellek yapılandırması varsayılanları. Honcho gibi harici bellek sağlayıcıları, bilinçli şekilde taşıyabilmeniz için arşiv veya elle inceleme öğeleri olarak kaydedilir.
skills/<name>/ altında bir SKILL.md dosyası bulunan Skills, skills.config içindeki Skill başına yapılandırma değerleriyle birlikte kopyalanır.
Etkileşimli openclaw migrate, kimlik doğrulama bilgilerini içe aktarmadan önce sorar ve varsayılan olarak evet seçilidir. Kabul edilen içe aktarımlar arasında OpenCode auth.json dosyasından OpenCode OpenAI OAuth kimlik bilgileri, OpenCode auth.json dosyasından OpenCode ve GitHub Copilot girdileri ve desteklenen .env anahtarları yer alır. Hermes auth.json OAuth girdileri eski durumdur ve canlı kimlik doğrulamaya içe aktarılmak yerine elle yeniden kimlik doğrulama/doctor işi olarak gösterilir. Etkileşimsiz openclaw migrate kimlik bilgisi içe aktarımı için --include-secrets, bunu atlamak için --no-auth-credentials veya ilk kurulum sihirbazından içe aktarırken --import-secrets kullanın.

​
Yalnızca arşivde kalanlar

Sağlayıcı bunları elle inceleme için geçiş raporu dizinine kopyalar, ancak canlı OpenClaw yapılandırmasına veya kimlik bilgilerine yüklemez:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
Biçimler ve güven varsayımları sistemler arasında değişebileceği için OpenClaw bu durumu otomatik olarak yürütmeyi veya ona güvenmeyi reddeder. Arşivi inceledikten sonra ihtiyacınız olanları elle taşıyın.

​
Önerilen akış

1

Planı önizleyin

openclaw migrate hermes --dry-run
Plan, çakışmalar, atlanan öğeler ve hassas öğeler dahil değişecek her şeyi listeler. Plan çıktısı, iç içe geçmiş sır gibi görünen anahtarları redakte eder.
2

Yedekle uygulayın

openclaw migrate apply hermes --yes
OpenClaw uygulamadan önce bir yedek oluşturur ve doğrular. Bu etkileşimsiz örnek, gizli olmayan durumu içe aktarır. Kimlik bilgisi istemini yanıtlamak için --yes olmadan çalıştırın veya gözetimsiz çalıştırmalarda desteklenen kimlik bilgilerini dahil etmek için --include-secrets ekleyin.
3

Doctor çalıştırın

openclaw doctor
Doctor, bekleyen yapılandırma geçişlerini yeniden uygular ve içe aktarma sırasında ortaya çıkan sorunları kontrol eder.
4

Yeniden başlatın ve doğrulayın

openclaw gateway restart
openclaw status
Gateway’in sağlıklı olduğunu ve içe aktarılan modelinizin, belleğinizin ve Skills’in yüklendiğini doğrulayın.

​
Çakışma işleme

Plan çakışmalar bildirdiğinde (hedefte zaten bir dosya veya yapılandırma değeri varsa) uygulama devam etmeyi reddeder.
--overwrite ile yeniden çalıştırmayı yalnızca mevcut hedefi değiştirmek bilinçli bir tercihinizse yapın. Sağlayıcılar, geçiş raporu dizininde üzerine yazılan dosyalar için yine de öğe düzeyinde yedekler yazabilir.
Yeni bir OpenClaw kurulumu için çakışmalar olağan değildir. Genellikle içe aktarmayı zaten kullanıcı düzenlemeleri bulunan bir kurulumda yeniden çalıştırdığınızda görünürler. Uygulama sırasında ortada bir çakışma ortaya çıkarsa (örneğin, bir yapılandırma dosyasında beklenmeyen bir yarış durumu), Hermes kalan bağımlı yapılandırma öğelerini kısmen yazmak yerine blocked by earlier apply conflict nedeniyle skipped olarak işaretler. Geçiş raporu, özgün çakışmayı çözebilmeniz ve içe aktarmayı yeniden çalıştırabilmeniz için engellenen her öğeyi kaydeder.

​
Sırlar

Etkileşimli openclaw migrate, algılanan kimlik doğrulama bilgilerinin içe aktarılıp aktarılmayacağını sorar ve varsayılan olarak evet seçilidir.
  • İstemi kabul etmek, OpenCode auth.json dosyasından OpenCode OpenAI OAuth kimlik bilgilerini, OpenCode auth.json dosyasından OpenCode ve GitHub Copilot girdilerini ve desteklenen .env anahtarlarını içe aktarır. Hermes auth.json OAuth girdileri, elle OpenAI yeniden kimlik doğrulaması veya doctor onarımı için raporlanır.
  • Yalnızca gizli olmayan durumu içe aktarmak için --no-auth-credentials kullanın veya istemde hayırı seçin.
  • --yes ile gözetimsiz çalıştırırken --include-secrets kullanın.
  • İlk kurulum sihirbazından kimlik bilgilerini içe aktarırken --import-secrets kullanın.
  • SecretRef tarafından yönetilen kimlik bilgileri için, içe aktarma tamamlandıktan sonra SecretRef kaynağını yapılandırın.

​
Otomasyon için JSON çıktısı

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
--json kullanıldığında ve --yes verilmediğinde, uygulama planı yazdırır ve durumu değiştirmez. Bu, CI ve paylaşılan betikler için en güvenli moddur.

​
Sorun giderme

Plan çıktısını inceleyin. Her çakışma kaynak yolunu ve mevcut hedefi belirtir. Öğeye göre atlamaya, hedefi düzenlemeye veya --overwrite ile yeniden çalıştırmaya karar verin.
--from /actual/path (CLI) veya --import-source /actual/path (ilk kurulum) geçirin.
İlk kurulum içe aktarımları yeni bir kurulum gerektirir. Ya durumu sıfırlayıp ilk kurulumu yeniden yapın ya da --overwrite ve açık yedek kontrolünü destekleyen openclaw migrate apply hermes komutunu doğrudan kullanın.
Etkileşimli openclaw migrate, API anahtarlarını yalnızca kimlik bilgisi istemini kabul ettiğinizde içe aktarır. Etkileşimsiz --yes çalıştırmaları --include-secrets gerektirir; ilk kurulum içe aktarımları --import-secrets gerektirir. Yalnızca desteklenen .env anahtarları tanınır; .env içindeki diğer değişkenler yok sayılır.

​
İlgili

  • openclaw migrate: tam CLI başvurusu, Plugin sözleşmesi ve JSON şekilleri.
  • İlk kurulum: sihirbaz akışı ve etkileşimsiz bayraklar.
  • Geçiş: bir OpenClaw kurulumunu makineler arasında taşıma.
  • Doctor: geçiş sonrası sağlık kontrolü.
  • Ajan çalışma alanı: SOUL.md, AGENTS.md ve bellek dosyalarının bulunduğu yer.