# openclaw migrate

Başka bir aracı sisteminden durumu, Plugin tarafından sahip olunan bir migration provider üzerinden içe aktarın. Paketle birlikte gelen sağlayıcılar Codex CLI durumunu, Claude ve Hermes durumunu kapsar; üçüncü taraf Plugin sağlayıcıları ek sağlayıcılar kaydedebilir.

# Komutlar

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Kayıtlı bir migration provider adı, örneğin hermes. Kurulu sağlayıcıları görmek için openclaw migrate list komutunu çalıştırın.

--dry-runboolean

Planı oluşturun ve durumu değiştirmeden çıkın.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Kaynak durum dizinini geçersiz kılın. Hermes varsayılan olarak ~/.hermes kullanır.

--include-secretsboolean

Desteklenen kimlik bilgilerini içe aktarın. Varsayılan olarak kapalıdır.

--overwriteboolean

Plan çakışmalar bildirdiğinde apply işleminin mevcut hedefleri değiştirmesine izin verin.

--yesboolean

Onay istemini atlayın. Etkileşimsiz modda zorunludur.

"--skill

--no-backupboolean

Apply öncesi yedeklemeyi atlayın. Yerel OpenClaw durumu varsa --force gerektirir.

--forceboolean

Apply işlemi aksi halde yedeklemeyi atlamayı reddedecekse --no-backup ile birlikte zorunludur.

--jsonboolean

Planı veya apply sonucunu JSON olarak yazdırın. --json ile ve --yes olmadan, apply planı yazdırır ve durumu değiştirmez.

# Güvenlik modeli

openclaw migrate önce önizleme yapar.

# Claude sağlayıcısı

Paketle birlikte gelen Claude sağlayıcısı, varsayılan olarak ~/.claude konumundaki Claude Code durumunu algılar. Belirli bir Claude Code ana dizinini veya proje kökünü içe aktarmak için --from <path> kullanın.

# Claude neleri içe aktarır

• Proje CLAUDE.md ve .claude/CLAUDE.md dosyalarını OpenClaw aracı çalışma alanına.
• Kullanıcı ~/.claude/CLAUDE.md içeriğini çalışma alanı USER.md dosyasına ekler.
• Proje .mcp.json, Claude Code ~/.claude.json ve Claude Desktop claude_desktop_config.json dosyalarından MCP sunucu tanımları.
• SKILL.md içeren Claude skill dizinleri.
• Yalnızca manuel çağırmayla OpenClaw skills öğelerine dönüştürülen Claude komut Markdown dosyaları.

# Arşiv ve manuel inceleme durumu

Claude hooks, izinler, ortam varsayılanları, yerel bellek, yol kapsamlı kurallar, alt aracılar, önbellekler, planlar ve proje geçmişi migration report içinde korunur veya manuel inceleme öğeleri olarak raporlanır. OpenClaw hooks çalıştırmaz, geniş izin listelerini kopyalamaz veya OAuth/Desktop kimlik bilgisi durumunu otomatik olarak içe aktarmaz.

# Codex sağlayıcısı

Paketle birlikte gelen Codex sağlayıcısı, varsayılan olarak ~/.codex konumundaki Codex CLI durumunu veya bu ortam değişkeni ayarlandığında CODEX_HOME konumunu algılar. Belirli bir Codex ana dizinini envanterlemek için --from <path> kullanın.

OpenClaw Codex harness ortamına geçerken ve yararlı kişisel Codex CLI varlıklarını bilinçli biçimde öne çıkarmak istediğinizde bu sağlayıcıyı kullanın. Yerel Codex app-server başlatmaları aracı başına CODEX_HOME ve HOME dizinleri kullanır, bu nedenle varsayılan olarak kişisel Codex CLI durumunuzu okumaz.

Etkileşimli bir terminalde openclaw migrate codex çalıştırmak tam planı önizler, ardından son apply onayından önce skill kopyalama öğeleri için bir onay kutusu seçici açar. Toplu seçim için Toggle all on veya Toggle all off kullanın; planlanan Skills işaretli başlar, çakışan Skills işaretsiz başlar ve Skip for now, apply yapmadan Skills öğelerini değiştirmeden bırakır. Betiklenmiş veya kesin çalıştırmalar için her skill başına bir kez --skill <name> geçirin, örneğin:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# Codex neleri içe aktarır

• Codex'in .system önbelleği hariç, $CODEX_HOME/skills altındaki Codex CLI skill dizinleri.
• Aracı başına sahiplik istediğinizde mevcut OpenClaw aracı çalışma alanına kopyalanan $HOME/.agents/skills altındaki kişisel AgentSkills.

# Manuel incelemeli Codex durumu

Codex yerel Plugin, config.toml ve yerel hooks/hooks.json otomatik olarak etkinleştirilmez. Plugin; MCP sunucuları, uygulamalar, hooks veya başka çalıştırılabilir davranışlar sunabilir, bu nedenle sağlayıcı bunları OpenClaw içine yüklemek yerine inceleme için raporlar. Yapılandırma ve hook dosyaları manuel inceleme için migration report içine kopyalanır.

# Hermes sağlayıcısı

Paketle birlikte gelen Hermes sağlayıcısı, varsayılan olarak ~/.hermes konumundaki durumu algılar. Hermes başka bir yerdeyse --from <path> kullanın.

# Hermes neleri içe aktarır

• config.yaml dosyasından varsayılan model yapılandırması.
• 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 dosyalarını OpenClaw aracı çalışma alanına.
• memories/MEMORY.md ve memories/USER.md dosyalarını çalışma alanı bellek dosyalarına ekler.
• OpenClaw dosya belleği için bellek yapılandırması varsayılanları, ayrıca Honcho gibi harici bellek sağlayıcıları için arşiv veya manuel inceleme öğeleri.
• skills/<name>/ altında SKILL.md dosyası içeren Skills.
• skills.config içinden skill başına yapılandırma değerleri.
• .env içinden desteklenen API anahtarları, yalnızca --include-secrets ile.

# Desteklenen .env anahtarları

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.

# Yalnızca arşivlenen durum

OpenClaw tarafından güvenli biçimde yorumlanamayan Hermes durumu, manuel inceleme için migration report içine kopyalanır, ancak canlı OpenClaw yapılandırmasına veya kimlik bilgilerine yüklenmez. Bu, OpenClaw'ın bunu otomatik olarak çalıştırabileceğini veya güvenebileceğini varsaymadan opak ya da güvenli olmayan durumu korur:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• auth.json
• state.db

# Uyguladıktan sonra

openclaw doctor

# Plugin sözleşmesi

Geçiş kaynakları Plugin'dir. Bir Plugin, sağlayıcı kimliklerini openclaw.plugin.json içinde bildirir:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

Çalışma zamanında Plugin api.registerMigrationProvider(...) çağırır. Sağlayıcı detect, plan ve apply uygular. Core; CLI orkestrasyonunu, yedekleme politikasını, istemleri, JSON çıktısını ve çakışma ön denetimini sahiplenir. Core, incelenmiş planı apply(ctx, plan) içine geçirir ve sağlayıcılar yalnızca bu bağımsız değişken uyumluluk için yoksa planı yeniden oluşturabilir.

Sağlayıcı Plugin; öğe oluşturma ve özet sayıları için openclaw/plugin-sdk/migration, ayrıca çakışma farkındalıklı dosya kopyaları, yalnızca arşiv rapor kopyaları, önbelleğe alınmış config-runtime sarmalayıcıları ve migration report için openclaw/plugin-sdk/migration-runtime kullanabilir.

# Onboarding entegrasyonu

Onboarding, bir sağlayıcı bilinen bir kaynak algıladığında geçiş önerebilir. Hem openclaw onboard --flow import hem de openclaw setup --wizard --import-from hermes aynı Plugin migration provider öğesini kullanır ve apply öncesinde yine de bir önizleme gösterir.

# İlgili

• Hermes'ten geçiş: kullanıcıya yönelik adım adım kılavuz.
• Claude'dan geçiş: kullanıcıya yönelik adım adım kılavuz.
• Geçiş: OpenClaw'ı yeni bir makineye taşıma.
• Doctor: geçiş uygulandıktan sonra sağlık denetimi.
• Plugins: Plugin kurulumu ve kaydı.