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

İçe aktarmanın iki yolu

İlk katılım sihirbazı

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

bash
openclaw onboard --flow import

Ya da belirli bir kaynağı gösterin:

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

CLI

Betikli 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
  • 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 sunucuları

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.

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

  • 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ştirilecek 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 aktarımdan sonra 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ı işleme

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

    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ı

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

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

    --from /actual/path (CLI) veya --import-source /actual/path (ilk katılım) iletin.

    İlk katılım, mevcut bir kurulumda içe aktarmayı reddediyor

    İ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'taki MCP sunucuları içe aktarılmadı

    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.

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

    Was this useful?
    On this page

    On this page