Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw, Hermes durumunu birlikte gelen bir geçiş sağlayıcısı aracılığıyla içe aktarır. Sağlayıcı, durumu değiştirmeden önce her şeyin önizlemesini gösterir, planlarda ve raporlarda gizli bilgileri redakte eder ve uygulamadan önce doğrulanmış bir yedek oluşturur.
İç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 veya 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 üzerinden yapılandırılmış model sağlayıcıları ve özel OpenAI uyumlu uç noktalar.
mcp_servers veya mcp.servers üzerinden 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ırma 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 SKILL.md dosyası bulunan Skills, skills.config içindeki beceriye özel yapılandırma değerleriyle birlikte kopyalanır.
Desteklenen .env anahtarlarını içe aktarmak için --include-secrets ayarlayın: OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY. Bayrak olmadan gizli bilgiler hiçbir zaman kopyalanmaz.

​
Yalnızca arşivde kalanlar

Sağlayıcı, elle inceleme 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/
  • auth.json
  • state.db
OpenClaw, biçimler ve güven varsayımları sistemler arasında farklılaşabileceği için 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ın önizlemesini gösterin

openclaw migrate hermes --dry-run
Plan; çakışmalar, atlanan öğeler ve tüm hassas öğeler dahil olmak üzere değişecek her şeyi listeler. Plan çıktısı, iç içe geçmiş gizli bilgi 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. API anahtarlarının içe aktarılması gerekiyorsa --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ı denetler.
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ışma bildirdiğinde uygulama devam etmeyi reddeder (hedefte zaten bir dosya veya yapılandırma değeri vardır).
Yalnızca mevcut hedefi değiştirmek bilinçli bir tercih olduğunda --overwrite ile yeniden çalıştırı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 kurulumunda ç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 bir çakışma ortaya çıkarsa (örneğin bir yapılandırma dosyasında beklenmeyen bir yarış), Hermes kalan bağımlı yapılandırma öğelerini kısmen yazmak yerine blocked by earlier apply conflict nedeni ile 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.

​
Gizli bilgiler

Gizli bilgiler varsayılan olarak hiçbir zaman içe aktarılmaz.
  • Gizli olmayan durumu içe aktarmak için önce openclaw migrate apply hermes --yes çalıştırın.
  • Desteklenen .env anahtarlarının da kopyalanmasını istiyorsanız --include-secrets ile yeniden çalıştırı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 ile ve --yes olmadan, 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. Her öğe için 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 aktarmaları yeni bir kurulum gerektirir. Durumu sıfırlayıp yeniden ilk kurulumu yapın ya da --overwrite ve açık yedek denetimini destekleyen openclaw migrate apply hermes komutunu doğrudan kullanın.
--include-secrets gereklidir ve yalnızca yukarıda listelenen 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 denetimi.
  • Ajan çalışma alanı: SOUL.md, AGENTS.md ve bellek dosyalarının bulunduğu yer.