Skip to main content
OpenClaw, paketle birlikte sunulan Claude geçiş sağlayıcısı aracılığıyla yerel Claude durumunu içe aktarır. Sağlayıcı, durumu değiştirmeden önce her öğenin önizlemesini gösterir ve planlar ile raporlardaki gizli bilgileri maskeler. Bağımsız openclaw migrate, doğrulanmış bir yedek oluşturur; yeni ilk katılım yolu içe aktarımı hazırlar ve yalnızca doğrulama başarılı olduktan sonra yayımlar.
İlk katılım iç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 veya planı inceledikten sonra --overwrite ile birlikte doğrudan openclaw migrate kullanın.

​
İçe aktarmanın iki yolu

Sihirbaz, yerel Claude durumu algıladığında Claude seçeneğini sunar.
Ya da belirli bir kaynağı gösterin:

​
İçe aktarılanlar

  • Proje CLAUDE.md ve .claude/CLAUDE.md içeriği, OpenClaw aracısının AGENTS.md çalışma alanına kopyalanır veya eklenir.
  • Kullanıcı ~/.claude/CLAUDE.md içeriği, çalışma alanındaki USER.md öğesine eklenir.
MCP sunucusu tanımları, mevcut olduklarında proje .mcp.json, Claude Code ~/.claude.json ve Claude Desktop claude_desktop_config.json öğelerinden içe aktarılır.
  • SKILL.md dosyası bulunan Claude Skills öğeleri, OpenClaw çalışma alanının Skills dizinine kopyalanır.
  • .claude/commands/ veya ~/.claude/commands/ altındaki Claude komut Markdown dosyaları, disable-model-invocation: true ile OpenClaw Skills öğelerine dönüştürülür.

​
Yalnızca arşivde kalanlar

Sağlayıcı, elle incelenmeleri için bunları geçiş raporuna kopyalar ancak canlı OpenClaw yapılandırmasına yüklemez:
  • Claude kancaları
  • Claude izinleri ve geniş araç izin listeleri
  • Claude ortam varsayılanları
  • CLAUDE.local.md
  • .claude/rules/
  • .claude/agents/ veya ~/.claude/agents/ altındaki Claude alt aracıları
  • Claude Code önbellekleri, planları ve proje geçmişi dizinleri
  • Claude Desktop uzantıları ve işletim sisteminde saklanan kimlik bilgileri
OpenClaw; kancaları yürütmeyi, izin listelerine güvenmeyi veya şeffaf olmayan OAuth ve Desktop kimlik bilgisi durumunu otomatik olarak çözmeyi reddeder. Arşivi inceledikten sonra ihtiyaç duyduklarınızı elle taşıyın.

​
Kaynak seçimi

--from olmadan OpenClaw, ~/.claude konumundaki varsayılan Claude Code ana dizinini, örneklenmiş Claude Code ~/.claude.json durum dosyasını ve macOS’taki Claude Desktop MCP yapılandırmasını inceler. --from bir proje kökünü gösterdiğinde OpenClaw yalnızca söz konusu projenin CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ ve .mcp.json gibi Claude dosyalarını içe aktarır. Proje kökü içe aktarımı sırasında genel Claude ana dizininizi okumaz.

​
Önerilen akış

1

Planın önizlemesini görüntüleyin

Plan; çakışmalar, atlanan öğeler ve iç içe MCP env veya headers alanlarında maskelenen hassas değerler dâhil olmak üzere değiştirilecek her şeyi listeler.
2

Yedek alarak uygulayın

OpenClaw, uygulamadan önce bir yedek oluşturur ve doğrular.
3

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

Doctor, içe aktarımdan sonra yapılandırma veya durum sorunlarını denetler.
4

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

Gateway’in sağlıklı olduğunu ve içe aktarılan talimatlarınızın, MCP sunucularınızın ve Skills öğelerinizin yüklendiğini doğrulayın.

​
Çakışmaları işleme

Plan çakışma bildirdiğinde (hedefte zaten bir dosya veya yapılandırma değeri mevcutsa) uygulama devam etmeyi reddeder.
Yalnızca mevcut hedefi değiştirmek bilerek isteniyorsa --overwrite ile yeniden çalıştırın. Sağlayıcılar, üzerine yazılan dosyalar için geçiş raporu dizinine öğe düzeyinde yedekler yazmaya devam edebilir.
Yeni bir OpenClaw kurulumunda çakışmalar olağan değildir. Genellikle içe aktarımı zaten kullanıcı düzenlemeleri bulunan bir kurulumda yeniden çalıştırdığınızda ortaya çıkarlar.

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

Etkileşimli bir terminal dışında migrate apply için --yes gereklidir; bu olmadan OpenClaw uygulamak yerine hata verir, dolayısıyla betikler ve CI açıkça --yes iletmelidir. Önce --dry-run --json ile önizleme yapın, ardından plan doğru göründüğünde --json --yes ile uygulayın.

​
Sorun giderme

--from /actual/path (CLI) veya --import-source /actual/path (ilk katılım) iletin.
İlk katılım içe aktarımları yeni bir kurulum gerektirir. Durumu sıfırlayıp ilk katılımı yeniden gerçekleştirin veya --overwrite ve açık yedekleme denetimini destekleyen openclaw migrate apply claude öğesini doğrudan kullanın.
Claude Desktop, platforma özgü bir yoldan claude_desktop_config.json dosyasını okur. OpenClaw bunu otomatik olarak algılamadıysa --from öğesini bu dosyanın dizinine yönlendirin.
Bu, tasarım gereğidir. Claude komutları kullanıcı tarafından tetiklendiğinden OpenClaw bunları disable-model-invocation: true ile Skills öğeleri olarak içe aktarır. Aracının bunları otomatik olarak çağırmasını istiyorsanız her Skill öğesinin frontmatter bölümünü düzenleyin.

​
İlgili