Skip to main content
Paketle birlikte gelen Hermes geçiş sağlayıcısı, HERMES_HOME ve etkin Hermes profilini izler; macOS/Linux’ta ~/.hermes, Windows’ta ise %LOCALAPPDATA%\hermes seçeneğine geri döner. Uygulamadan önce her değişikliğin önizlemesini gösterir ve planlar ile raporlardaki gizli bilgileri maskeler. Bağımsız openclaw migrate doğrulanmış bir yedek yazar; yeni ilk kurulum yolu yapılandırmayı, kimlik bilgilerini ve dosyaları hazırlar ve bunları yalnızca içe aktarılan çıkarım doğrulandıktan sonra yayımlar. Açıkça belirtilen bir --from yolu her zaman önceliklidir.
İçe aktarma işlemleri 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 apply hermes kullanın.

​
İçe aktarmanın iki yolu

Etkin Hermes ana dizinini/profilini algılar ve uygulamadan önce bir önizleme gösterir.
Veya belirli bir kaynağı gösterin:

​
İçe aktarılanlar

  • Hermes config.yaml kaynağındaki varsayılan model seçimi.
  • Mevcut Hermes Chat Completions, Codex Responses ve Anthropic Messages aktarımları dâhil olmak üzere model, providers ve custom_providers kaynaklarındaki yapılandırılmış model sağlayıcıları ve özel uç noktalar.
Devre dışı durumu, zaman aşımları, paralel araç desteği, OAuth kapsamı, uyumlu TLS alanları ve yerel/kaynak/istem araç politikası dâhil olmak üzere mcp_servers veya mcp.servers kaynağındaki MCP sunucu tanımları. Değişmez ortam değişkenleri ve üstbilgiler, kimlik bilgilerini içe aktarma izni gerektirir. Yalnızca Hermes’e özgü yaşam döngüsü, örnekleme, bilgi isteme, ön kontrol, bağlantıyı canlı tutma, CA paketi, parola korumalı istemci anahtarı ve önceden kaydedilmiş OAuth istemcisi ayarları, geçersiz OpenClaw yapılandırması yerine elle incelenecek öğelere dönüşür.
  • 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.
  • Yalnızca belleğe yönelik yüzeyler farklı davranır: İlk kurulum bellek sayfası ve Control UI Bellek içe aktarma sayfası, dizinlenmiş hatırlama için bu iki dosyayı memory/imports/hermes/ altına kopyalar ve mevcut çalışma alanı belleğine dokunmaz.
OpenClaw dosya belleği için bellek yapılandırması varsayılanları. Honcho gibi harici bellek sağlayıcıları, bunları bilinçli olarak taşıyabilmeniz için arşiv veya elle incelenecek öğeler olarak kaydedilir.
skills/ altında herhangi bir yerde SKILL.md dosyası bulunan Skills özyinelemeli olarak keşfedilir, OpenClaw çalışma alanı skill dizininde düzleştirilir ve destek dosyalarıyla birlikte kopyalanır. skills.config kaynağındaki skill başına yapılandırma değerleri korunur.
Etkileşimli openclaw migrate, varsayılan olarak evet seçiliyken kimlik doğrulama bilgilerini içe aktarmadan önce sorar. Kabul edilen içe aktarımlar arasında mevcut Hermes OpenAI Codex OAuth girdileri, OpenCode OpenAI OAuth ve GitHub Copilot girdileri ile desteklenen Hermes .env anahtarları bulunur. Etkileşimsiz içe aktarma için --include-secrets, kimlik bilgilerini atlamak için --no-auth-credentials veya ilk kurulumun --import-secrets bayrağını kullanın. Hermes OAuth’u içe aktardıktan sonra Hermes ile OpenClaw’ın aynı yenileme yetkisini kullanmasına izin vermeyin; ikisini birlikte çalıştırmadan önce taraflardan birinde yeniden kimlik doğrulayın.

​
Yalnızca arşivde kalanlar

Sağlayıcı, elle incelenmeleri için bunları geçiş raporu dizinine kopyalar ancak canlı OpenClaw yapılandırmasına veya kimlik bilgilerine yüklemez:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • plans/, workspace/, skins/ ve kanban/
  • pairing/ ve platforms/ depolarının yanı sıra gateway yönlendirme/işlem durumu
  • state.db, hermes_state.db, projects.db, response_store.db, memory_store.db, verification_evidence.db, kanban.db ve retaindb_queue.db
Biçimler ve güven varsayımları sistemler arasında farklılaşabileceğinden OpenClaw bu durumu otomatik olarak yürütmeyi veya güvenilir kabul etmeyi reddeder. Arşivi inceledikten sonra ihtiyaç duyduklarınızı elle taşıyın.

​
Önerilen akış

1

Planın önizlemesini gösterin

Plan; çakışmalar, atlanan öğeler ve hassas öğeler dâhil olmak üzere değişecek her şeyi listeler. İç içe geçmiş, gizli bilgiye benzeyen anahtarlar çıktıda maskelenir.
2

Yedekle birlikte uygulayın

OpenClaw uygulamadan önce bir yedek oluşturur ve doğrular. Bu etkileşimsiz örnek yalnızca gizli olmayan durumu içe aktarır. Kimlik bilgileri istemini etkileşimli olarak yanıtlamak için --yes olmadan çalıştırın veya gözetimsiz bir çalıştırmada desteklenen kimlik bilgilerini dâhil etmek için --include-secrets ekleyin.
3

Doctor'ı çalıştırın

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

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

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 yönetimi

Plan çakışma bildirdiğinde (hedefte zaten bir dosya veya yapılandırma değeri bulunduğunda) uygulama devam etmeyi reddeder.
Yalnızca mevcut hedefin değiştirilmesi amaçlanıyorsa --overwrite ile yeniden çalıştırın. Sağlayıcılar, üzerine yazılan dosyalar için geçiş raporu dizinine yine de öğe düzeyinde yedekler yazabilir.
Yeni bir kurulumda çakışmalar olağan dışıdır. Genellikle içe aktarmayı kullanıcı düzenlemeleri bulunan bir kurulumda yeniden çalıştırdığınızda ortaya çıkarlar. Uygulamanın ortasında bir çakışma ortaya çıkarsa (örneğin, bir yapılandırma dosyasında beklenmeyen bir yarış durumu), bağımsız dosyalar, Skills, kimlik bilgileri, arşivler ve yapılandırma girdileri devam ederken bu öğe çakışma olarak bildirilir. Çakışan öğeyi çözün ve içe aktarmayı yeniden çalıştırın; aynı bellek içe aktarımları eş etkisizdir.

​
Gizli bilgiler

Etkileşimli openclaw migrate, algılanan kimlik doğrulama bilgilerini içe aktarıp aktarmayacağınızı varsayılan olarak evet seçiliyken sorar.
  • Kabul edildiğinde mevcut Hermes OpenAI Codex OAuth girdileri, OpenCode OpenAI OAuth ve GitHub Copilot girdileri ile desteklenen .env anahtarları içe aktarılır.
  • Yalnızca gizli olmayan durumu içe aktarmak için --no-auth-credentials kullanın veya istemde hayır yanıtını verin.
  • Gözetimsiz bir --yes çalıştırmasında kimlik bilgilerini içe aktarmak için --include-secrets kullanın.
  • Kimlik bilgilerini sihirbazdan içe aktarmak için ilk kurulum sihirbazının --import-secrets bayrağını kullanın.

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

--json kullanıldığında ve --yes kullanılmadığında 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 tanımlar. Her öğe için atlama, hedefi düzenleme veya --overwrite ile yeniden çalıştırma seçeneklerinden birini belirleyin.
--from /actual/path (CLI) veya --import-source /actual/path (ilk kurulum) iletin.
İlk kurulumdan içe aktarma yeni bir kurulum gerektirir. Durumu sıfırlayıp ilk kurulumu yeniden yapın veya --overwrite ve açık yedekleme denetimini destekleyen openclaw migrate apply hermes komutunu doğrudan kullanın.
Etkileşimli openclaw migrate, API anahtarlarını yalnızca kimlik bilgileri istemini kabul ettiğinizde içe aktarır. Etkileşimsiz --yes çalıştırmaları --include-secrets; ilk kurulum içe aktarmaları ise --import-secrets gerektirir. Yalnızca desteklenen .env anahtarları tanınır; diğer .env değişkenleri yok sayılır.

​
İlgili kaynaklar

  • 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ı sistem durumu denetimi.
  • Ajan çalışma alanı: SOUL.md, AGENTS.md ve bellek dosyalarının bulunduğu yer.