OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Claude'dan Geçiş

OpenClaw, yerel Claude durumunu paketle gelen Claude geçiş sağlayıcısı aracılığıyla içe aktarır. Sağlayıcı, durumu değiştirmeden önce her öğenin önizlemesini gösterir, planlarda ve raporlarda gizli bilgileri maskeler ve uygulamadan önce doğrulanmış bir yedek oluşturur.

İçe aktarmanın iki yolu

İlk kurulum sihirbazı

Sihirbaz, yerel Claude durumu algıladığında Claude seçeneğini sunar.

bash
openclaw onboard --flow import

Ya da belirli bir kaynak belirtin:

bash
openclaw onboard --import-from claude --import-source ~/.claude

CLI

Betikleştirilmiş veya tekrarlanabilir çalıştırmalar için openclaw migrate kullanın. Tam başvuru için openclaw migrate sayfasına bakın.

bash
openclaw migrate claude --dry-runopenclaw migrate apply claude --yes

Belirli bir Claude Code ana dizinini veya proje kökünü içe aktarmak için --from <path> ekleyin.

İçe aktarılanlar

Talimatlar ve bellek
  • Projedeki CLAUDE.md ve .claude/CLAUDE.md içeriği, OpenClaw aracısının çalışma alanındaki AGENTS.md dosyasına kopyalanır veya eklenir.
  • Kullanıcının ~/.claude/CLAUDE.md içeriği, çalışma alanındaki USER.md dosyasına eklenir.
MCP sunucuları

MCP sunucu tanımları, mevcut olduklarında projedeki .mcp.json, Claude Code ~/.claude.json ve Claude Desktop claude_desktop_config.json dosyalarından içe aktarılır.

Skills ve komutlar
  • 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 ayarlı 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ı çalıştırmayı, izin listelerine güvenmeyi veya anlaşılmaz 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

OpenClaw, --from kullanılmadığında ~/.claude konumundaki varsayılan Claude Code ana dizinini, örneklenen 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 o projeye ait 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ış

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

    bash
    openclaw migrate claude --dry-run

    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şecek her şeyi listeler.

  • Yedek alarak uygulayın

    bash
    openclaw migrate apply claude --yes

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

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

    bash
    openclaw doctor

    Doctor, içe aktarma sonrasında yapılandırma veya durum sorunlarını denetler.

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

    bash
    openclaw gateway restartopenclaw status

    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ın işlenmesi

    Plan çakışma bildirdiğinde (hedefte zaten bir dosya veya yapılandırma değeri bulunduğunda) uygulama devam etmeyi reddeder.

    Yeni bir OpenClaw kurulumunda çakışmalar olağan değildir. Bunlar genellikle içe aktarmayı, kullanıcı düzenlemeleri bulunan bir kurulumda yeniden çalıştırdığınızda ortaya çıkar.

    Otomasyon için JSON çıktısı

    bash
    openclaw migrate claude --dry-run --jsonopenclaw migrate apply claude --json --yes

    Etkileşimli bir terminal dışında migrate apply için --yes gereklidir; bu seçenek olmadan OpenClaw uygulama yapmak yerine hata verir. Bu nedenle betikler ve CI, --yes seçeneğini açıkça 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

    Claude durumu ~/.claude dışında bulunuyor

    --from /actual/path (CLI) veya --import-source /actual/path (ilk kurulum) seçeneğini iletin.

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

    İlk kurulum sırasında 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 claude komutunu doğrudan kullanın.

    Claude Desktop'taki MCP sunucuları içe aktarılmadı

    Claude Desktop, claude_desktop_config.json dosyasını platforma özgü bir yoldan okur. OpenClaw dosyayı otomatik olarak algılamadıysa --from seçeneğini bu dosyanın dizinine yöneltin.

    Claude komutları, model çağrısı devre dışı bırakılmış Skills öğelerine dönüştü

    Bu, tasarım gereğidir. Claude komutları kullanıcı tarafından tetiklendiğinden OpenClaw bunları disable-model-invocation: true ayarlı Skills öğeleri olarak içe aktarır. Aracının bunları otomatik olarak çağırmasını istiyorsanız her Skill öğesinin ön madde alanını düzenleyin.

    İlgili konular

    Was this useful?
    On this page

    On this page