English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Hermes'ten geçiş

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 aktarmanın iki yolu

İlk kurulum sihirbazı

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

CLI

Betiklenmiş veya tekrarlanabilir çalıştırmalar için openclaw migrate kullanın. Tam başvuru için openclaw migrate bölümüne bakın.

openclaw migrate hermes --dry-run    # preview only
openclaw migrate apply hermes --yes  # apply with confirmation skipped

Hermes ~/.hermes dışında bulunuyorsa --from <path> ekleyin.

Neler içe aktarılır

Model yapılandırması
  • 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 sunucuları

mcp_servers veya mcp.servers üzerinden MCP sunucu tanımları.

Çalışma alanı dosyaları
  • 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.
Bellek yapılandırması

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

skills/<name>/ altında SKILL.md dosyası bulunan Skills, skills.config içindeki beceriye özel yapılandırma değerleriyle birlikte kopyalanır.

API anahtarları (isteğe bağlı)

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ış

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

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

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

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

    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

    Uygulama çakışmalarla reddediliyor

    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.

    Hermes ~/.hermes dışında bulunuyor

    --from /actual/path (CLI) veya --import-source /actual/path (ilk kurulum) geçirin.

    İlk kurulum mevcut bir kurulumda içe aktarmayı reddediyor

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

    API anahtarları içe aktarılmadı

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