Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw, yerel Claude durumunu paketle birlikte gelen Claude migration sağlayıcısı aracılığıyla içe aktarır. Sağlayıcı, durumu değiştirmeden önce her öğeyi önizler, planlarda ve raporlarda gizli bilgileri redakte eder ve uygulamadan önce doğrulanmış bir yedek oluşturur.
Onboarding 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ı gözden geçirdikten sonra --overwrite ile doğrudan openclaw migrate kullanın.

​
İçe aktarmanın iki yolu

Sihirbaz, yerel Claude durumunu algıladığında Claude seçeneğini sunar.
openclaw onboard --flow import
Ya da belirli bir kaynağı gösterin:
openclaw onboard --import-from claude --import-source ~/.claude

​
Neler içe aktarılır

  • Proje CLAUDE.md ve .claude/CLAUDE.md içeriği OpenClaw ajan çalışma alanındaki AGENTS.md dosyasına kopyalanır veya eklenir.
  • Kullanıcı ~/.claude/CLAUDE.md içeriği çalışma alanındaki USER.md dosyasına eklenir.
MCP sunucu tanımları, mevcut olduğunda proje .mcp.json, Claude Code ~/.claude.json ve Claude Desktop claude_desktop_config.json dosyalarından içe aktarılır.
  • SKILL.md dosyası olan Claude skills, OpenClaw çalışma alanı 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.

​
Neler yalnızca arşiv olarak kalır

Sağlayıcı bunları elle gözden geçirmek üzere migration raporuna kopyalar, ancak canlı OpenClaw yapılandırmasına yüklemez:
  • Claude hook’ları
  • 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 ajanları
  • Claude Code önbellekleri, planları ve proje geçmişi dizinleri
  • Claude Desktop uzantıları ve işletim sisteminde saklanan kimlik bilgileri
OpenClaw hook’ları yürütmeyi, izin listelerine güvenmeyi veya opak OAuth ve Desktop kimlik bilgisi durumunu otomatik olarak çözmeyi reddeder. İhtiyacınız olanları arşivi gözden geçirdikten sonra elle taşıyın.

​
Kaynak seçimi

--from olmadan OpenClaw, ~/.claude konumundaki varsayılan Claude Code ana dizinini, örneklenen Claude Code ~/.claude.json durum dosyasını ve macOS üzerindeki Claude Desktop MCP yapılandırmasını inceler. --from bir proje kökünü gösterdiğinde OpenClaw yalnızca o 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 global Claude ana dizininizi okumaz.

​
Önerilen akış

1

Preview the plan

openclaw migrate claude --dry-run
Plan; çakışmalar, atlanan öğeler ve iç içe MCP env veya headers alanlarından redakte edilen hassas değerler dahil olmak üzere değişecek her şeyi listeler.
2

Apply with backup

openclaw migrate apply claude --yes
OpenClaw, uygulamadan önce bir yedek oluşturur ve doğrular.
3

Run doctor

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

Restart and verify

openclaw gateway restart
openclaw 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ışma yönetimi

Plan çakışmalar bildirdiğinde uygulama devam etmeyi reddeder (hedefte zaten bir dosya veya yapılandırma değeri vardır).
--overwrite ile yalnızca mevcut hedefi değiştirmek bilinçli bir tercihse yeniden çalıştırın. Sağlayıcılar, üzerine yazılan dosyalar için migration raporu dizininde yine de öğe düzeyinde yedekler yazabilir.
Yeni bir OpenClaw kurulumu için çakışmalar olağan değildir. Genellikle içe aktarımı, zaten kullanıcı düzenlemeleri olan bir kurulumda yeniden çalıştırdığınızda ortaya çıkarlar.

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

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --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

--from /actual/path (CLI) veya --import-source /actual/path (onboarding) iletin.
Onboarding içe aktarımları yeni bir kurulum gerektirir. Ya durumu sıfırlayıp onboarding’i yeniden çalıştırın ya da doğrudan openclaw migrate apply claude kullanın; bu komut --overwrite ve açık yedekleme denetimini destekler.
Claude Desktop, claude_desktop_config.json dosyasını platforma özgü bir yoldan okur. OpenClaw bunu otomatik algılamadıysa --from değerini o dosyanın dizinine yönlendirin.
Tasarım gereği böyledir. Claude komutları kullanıcı tarafından tetiklenir, bu nedenle OpenClaw bunları disable-model-invocation: true ile skills olarak içe aktarır. Ajanın bunları otomatik çağırmasını istiyorsanız her skill’in frontmatter bölümünü düzenleyin.

​
İlgili