openclaw migrate

Plugin'e ait bir geçiş sağlayıcısı aracılığıyla başka bir ajan sisteminden durumu içe aktarın. Birlikte gelen sağlayıcılar Claude, Codex CLI ve Hermes desteği sunar; Plugin'ler ek sağlayıcılar kaydedebilir.

Komutlar

openclaw migrate listopenclaw migrate claude --dry-runopenclaw migrate codex --dry-runopenclaw migrate codex --skill gog-vault77-google-workspaceopenclaw migrate codex --plugin google-calendar --dry-runopenclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-runopenclaw migrate hermes --dry-runopenclaw migrate hermesopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --plugin google-calendaropenclaw migrate apply codex --yesopenclaw migrate apply claude --yesopenclaw migrate apply hermes --yesopenclaw migrate apply hermes --include-secrets --yesopenclaw onboard --flow importopenclaw onboard --import-from claude --import-source ~/.claudeopenclaw onboard --import-from hermes --import-source ~/.hermes

Başka bayrak olmadan openclaw migrate <provider> çalıştırıldığında uygulama öncesinde plan oluşturulur, önizleme gösterilir ve (bir TTY'de) onay istenir. openclaw migrate plan <provider> ve openclaw migrate apply <provider>, aynı bayrakları kullanarak önizleme ve uygulama işlemlerini ayrı alt komutlara böler.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Kayıtlı bir geçiş sağlayıcısının adı; örneğin hermes. Yüklü sağlayıcıları görmek için openclaw migrate list komutunu çalıştırın.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Kaynak durum dizinini geçersiz kılın. Hermes varsayılan olarak ~/.hermes, Codex ~/.codex (veya $CODEX_HOME), Claude ise ~/.claude kullanır.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> Plugin adına veya öğe kimliğine göre bir Codex Plugin kurulum öğesi seçin. Birden fazla Codex Plugin'ini taşımak için bayrağı tekrarlayın. Belirtilmediğinde etkileşimli Codex geçişleri yerel bir Codex Plugin onay kutusu seçicisi gösterir, etkileşimsiz geçişler ise planlanan tüm Plugin'leri korur. Yalnızca Codex uygulama sunucusu envanteri tarafından keşfedilen ve kaynaktan yüklenmiş openai-curated Codex Plugin'leri için geçerlidir.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tYmFja3VwLW91dHB1dCA8cGF0aA " type="string"> Geçiş öncesi yedek arşivinin yolu veya dizini. openclaw backup create komutuna iletilir.

Güvenlik modeli

openclaw migrate önce önizleme yaklaşımını kullanır.

Claude sağlayıcısı

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'un içe aktardıkları

• Proje CLAUDE.md ve .claude/CLAUDE.md dosyalarını OpenClaw ajan çalışma alanına (AGENTS.md) aktarır.
• Kullanıcıya ait ~/.claude/CLAUDE.md içeriğini çalışma alanındaki USER.md dosyasına ekler.
• Proje .mcp.json dosyasından, Claude Code ~/.claude.json dosyasından (proje başına girdileri dahil) ve Claude Desktop claude_desktop_config.json dosyasından MCP sunucu tanımlarını aktarır.
• SKILL.md içeren Claude Skills dizinlerini (kullanıcı ~/.claude/skills ve proje .claude/skills) aktarır.
• Claude komut Markdown dosyalarını (kullanıcı ~/.claude/commands ve proje .claude/commands) yalnızca elle çağrılabilen OpenClaw Skills öğelerine dönüştürür.

Arşiv ve elle inceleme durumu

Claude kancaları, izinleri, ortam varsayılanları, proje CLAUDE.local.md dosyası, .claude/rules, kullanıcı ve proje agents/ dizinleri ile proje geçmişi (~/.claude altındaki projects, cache, plans) geçiş raporunda korunur veya elle incelenecek öğeler olarak bildirilir. OpenClaw kancaları çalıştırmaz, geniş izin listelerini kopyalamaz veya OAuth/Desktop kimlik bilgisi durumunu otomatik olarak içe aktarmaz.

Codex sağlayıcısı

Birlikte gelen Codex sağlayıcısı, varsayılan olarak ~/.codex konumundaki veya bu ortam değişkeni ayarlanmışsa CODEX_HOME konumundaki Codex CLI durumunu algılar. Belirli bir Codex ana dizininin envanterini çıkarmak için --from <path> kullanın.

OpenClaw Codex çalışma düzeneğine geçerken ve yararlı kişisel Codex CLI varlıklarını bilinçli biçimde aktarmak istediğinizde bu sağlayıcıyı kullanın. Yerel Codex uygulama sunucusu başlatmaları ajan başına bir CODEX_HOME kullanır; bu nedenle varsayılan olarak kişisel ~/.codex dizininizi okumaz. Normal işlem HOME değeri yine devralındığından Codex, paylaşılan $HOME/.agents/* Skills/Plugin pazar yeri girdilerini görebilir ve alt işlemler kullanıcı ana dizinindeki yapılandırmayı ve belirteçleri bulabilir.

Etkileşimli bir terminalde openclaw migrate codex çalıştırıldığında önce tam planın önizlemesi gösterilir, ardından son uygulama onayından önce onay kutusu seçicileri açılır. Önce Skills kopyalama öğeleri sorulur. Toplu seçim için Toggle all on veya Toggle all off kullanın. Satırları açıp kapatmak için Boşluk tuşuna, vurgulanan satırı etkinleştirip devam etmek için Enter tuşuna basın. Planlanan Skills öğeleri işaretli, çakışan Skills öğeleri işaretsiz başlar; Skip for now, Plugin seçimine devam ederken bu çalıştırmadaki Skills kopyalamalarını atlar. Kaynaktan yüklenmiş, seçilmiş Codex Plugin'leri taşınabilir durumdaysa ve --plugin belirtilmemişse geçiş, ardından Plugin adına göre yerel Codex Plugin etkinleştirmesi için seçim ister. Hedef OpenClaw Codex Plugin yapılandırmasında ilgili Plugin zaten yoksa Plugin öğeleri işaretli başlar. Mevcut hedef Plugin'ler işaretsiz başlar ve conflict: plugin exists gibi bir çakışma ipucu gösterir; o çalıştırmada hiçbir yerel Codex Plugin'ini taşımamak için Toggle all off, uygulamadan önce durmak için ise Skip for now seçeneğini belirleyin.

Betikli veya kesin çalıştırmalarda bir ya da daha fazla Skills öğesini veya Plugin'i açıkça seçin:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

Codex'in içe aktardıkları

• Codex'in .system önbelleği hariç, $CODEX_HOME/skills altındaki Codex CLI Skills dizinleri.
• $HOME/.agents/skills altındaki kişisel AgentSkills öğeleri; ajan başına sahiplik için geçerli OpenClaw ajan çalışma alanına kopyalanır.
• Codex uygulama sunucusu plugin/list aracılığıyla keşfedilen, kaynaktan yüklenmiş openai-curated Codex Plugin'leri. Planlama, etkinleştirilmiş ve yüklü her Plugin için plugin/read çağrısını kullanır.

Uygulama destekli Plugin geçişinin ek denetimleri vardır:

• Uygulama destekli Plugin'ler, kaynak Codex uygulama sunucusu hesabının bir ChatGPT abonelik hesabı olmasını gerektirir. ChatGPT dışı hesap yanıtları veya eksik hesap yanıtları codex_subscription_required nedeniyle atlanır.
• Geçiş varsayılan olarak kaynakta app/list çağrısı yapmaz; dolayısıyla hesap denetimini geçen uygulama destekli Plugin'ler, kaynak uygulama erişilebilirliği doğrulanmadan planlanır ve hesap sorgusu aktarım hataları codex_account_unavailable nedeniyle atlanır.
• Yeni bir kaynak app/list anlık görüntüsünü zorlamak ve yerel etkinleştirmeyi planlamadan önce sahip olunan her uygulamanın mevcut, etkin ve erişilebilir olmasını şart koşmak için --verify-plugin-apps seçeneğini kullanın. Bu modda hesap sorgusu aktarım hataları, kaynak uygulama envanteri doğrulamasına geçer. Anlık görüntü yalnızca geçerli işlem boyunca bellekte tutulur; geçiş çıktısına veya hedef yapılandırmaya hiçbir zaman yazılmaz.

Devre dışı Plugin'ler, okunamayan Plugin ayrıntıları, abonelik denetimine takılan kaynak hesapları ve (--verify-plugin-apps ayarlandığında) eksik, devre dışı veya erişilemeyen uygulamalar, hedef yapılandırma girdileri yerine türü belirtilmiş nedenlere sahip ve elle incelenecek atlanmış öğelere dönüşür. Uygulama, hedef uygulama sunucusu ilgili Plugin'i zaten yüklü ve etkin olarak bildirse bile seçilen her uygun Plugin için uygulama sunucusunda plugin/install çağrısı yapar. Taşınan Codex Plugin'leri yalnızca yerel Codex çalışma düzeneğini seçen oturumlarda kullanılabilir; OpenClaw sağlayıcı çalıştırmalarına, ACP konuşma bağlamalarına veya diğer çalışma düzeneklerine sunulmaz.

Elle incelenecek Codex durumu

Codex config.toml, yerel hooks/hooks.json, seçilmiş olmayan pazar yerleri, kaynaktan yüklenmiş seçilmiş Plugin niteliğinde olmayan önbelleğe alınmış Plugin paketleri ve kaynak abonelik denetiminde başarısız olan, kaynaktan yüklenmiş Plugin'ler otomatik olarak etkinleştirilmez. --verify-plugin-apps ayarlandığında kaynak uygulama envanteri denetiminde başarısız olan Plugin'ler de atlanır. Bunların tümü elle incelenmek üzere geçiş raporuna kopyalanır veya raporda bildirilir.

Kaynaktan yüklenmiş ve taşınmış seçilmiş Plugin'ler için uygulama şunları yazar:

• plugins.entries.codex.enabled: true
• plugins.entries.codex.config.codexPlugins.enabled: true
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
• seçilen her Plugin için marketplaceName: "openai-curated" ve pluginName içeren açık bir Plugin girdisi

Geçiş hiçbir zaman plugins["*"] yazmaz ve yerel pazar yeri önbellek yollarını hiçbir zaman saklamaz.

Atlanan Plugin'ler hedef yapılandırmaya yazılmaz. Kaynak tarafındaki abonelik hataları, elle incelenecek öğelerde türü belirtilmiş nedenlerle bildirilir: codex_subscription_required, codex_account_unavailable, plugin_disabled veya plugin_read_unavailable. --verify-plugin-apps kullanıldığında, kaynak uygulama envanteri hataları ayrıca app_inaccessible, app_disabled, app_missing veya app_inventory_unavailable olarak görünebilir. Hedef tarafında kimlik doğrulama gerektiren kurulumlar, etkilenen Plugin öğesinde status: "skipped", reason: "auth_required" ve arındırılmış uygulama tanımlayıcılarıyla bildirilir; bunlara ait açık yapılandırma girdileri, yeniden yetkilendirip etkinleştirene kadar devre dışı olarak yazılır. Diğer kurulum hataları, öğe kapsamlı error sonuçlarıdır.

Planlama sırasında Codex uygulama sunucusunun Plugin envanterine erişilemiyorsa geçiş, tüm geçişi başarısız kılmak yerine önbelleğe alınmış paket öneri öğelerine geri döner.

Hermes sağlayıcısı

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

Hermes'in içe aktardıkları

• config.yaml dosyasındaki varsayılan model yapılandırması.
• providers ve custom_providers içindeki yapılandırılmış model sağlayıcıları ve özel OpenAI uyumlu uç noktalar.
• mcp_servers veya mcp.servers içindeki MCP sunucusu tanımları.
• OpenClaw aracısı çalışma alanına SOUL.md ve AGENTS.md.
• Çalışma alanı bellek dosyalarına eklenen memories/MEMORY.md ve memories/USER.md.
• OpenClaw dosya belleği için bellek yapılandırması varsayılanları ile Honcho gibi harici bellek sağlayıcılarına yönelik arşiv veya elle inceleme öğeleri.
• skills/<name>/ altında bir SKILL.md dosyası içeren Skills.
• skills.config içindeki Skills başına yapılandırma değerleri.
• Etkileşimli kimlik bilgisi geçişi kabul edildiğinde veya --include-secrets ayarlandığında OpenCode auth.json dosyasındaki OpenCode OpenAI OAuth kimlik bilgileri. Hermes auth.json OAuth girdileri, OpenAI için elle yeniden kimlik doğrulama veya doctor onarımı gerektiren eski durum olarak bildirilir.
• Etkileşimli kimlik bilgisi geçişi kabul edildiğinde veya --include-secrets ayarlandığında Hermes .env ve OpenCode auth.json dosyalarındaki desteklenen API anahtarları ve belirteçler.

Desteklenen .env anahtarları

AI_GATEWAY_API_KEY, ALIBABA_API_KEY, ANTHROPIC_API_KEY, ARCEEAI_API_KEY, CEREBRAS_API_KEY, CHUTES_API_KEY, CLOUDFLARE_AI_GATEWAY_API_KEY, COPILOT_GITHUB_TOKEN, DASHSCOPE_API_KEY, DEEPINFRA_API_KEY, DEEPSEEK_API_KEY, FIREWORKS_API_KEY, GEMINI_API_KEY, GH_TOKEN, GITHUB_TOKEN, GLM_API_KEY, GOOGLE_API_KEY, GROQ_API_KEY, HF_TOKEN, HUGGINGFACE_HUB_TOKEN, KILOCODE_API_KEY, KIMICODE_API_KEY, KIMI_API_KEY, MINIMAX_API_KEY, MINIMAX_CODING_API_KEY, MISTRAL_API_KEY, MODELSTUDIO_API_KEY, MOONSHOT_API_KEY, NVIDIA_API_KEY, OPENAI_API_KEY, OPENCODE_API_KEY, OPENCODE_GO_API_KEY, OPENCODE_ZEN_API_KEY, OPENROUTER_API_KEY, QIANFAN_API_KEY, QWEN_API_KEY, TOGETHER_API_KEY, VENICE_API_KEY, XAI_API_KEY, XIAOMI_API_KEY, ZAI_API_KEY, Z_AI_API_KEY.

Yalnızca arşivlenen durum

OpenClaw'ın güvenli biçimde yorumlayamadığı Hermes durumu, elle incelenmek üzere geçiş raporuna kopyalanır ancak canlı OpenClaw yapılandırmasına veya kimlik bilgilerine yüklenmez. Böylece OpenClaw'ın bu durumu otomatik olarak yürütebildiği veya ona güvenebildiği varsayılmadan, belirsiz ya da güvenli olmayan durum korunur: plugins/, sessions/, logs/, cron/, mcp-tokens/, state.db.

Uyguladıktan sonra

openclaw doctor

Plugin sözleşmesi

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

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

Çalışma zamanında Plugin, api.registerMigrationProvider(...) çağrısını yapar. Sağlayıcı detect, plan ve apply işlevlerini uygular. CLI düzenlemesi, yedekleme politikası, istemler, JSON çıktısı ve çakışma ön denetimi çekirdeğin sorumluluğundadır. Çekirdek, incelenmiş planı apply(ctx, plan) işlevine geçirir; sağlayıcılar uyumluluk amacıyla planı yalnızca bu bağımsız değişken yoksa yeniden oluşturabilir.

Sağlayıcı Plugin'leri, öğe oluşturma ve özet sayımları için openclaw/plugin-sdk/migration; çakışmaları dikkate alan dosya kopyaları, yalnızca arşiv raporu kopyaları, önbelleğe alınmış yapılandırma çalışma zamanı sarmalayıcıları ve geçiş raporları için de openclaw/plugin-sdk/migration-runtime kullanabilir.

İlk kurulum entegrasyonu

İlk kurulum, bir sağlayıcı bilinen bir kaynak algıladığında geçiş seçeneği sunabilir. Hem openclaw onboard --flow import hem de openclaw setup --wizard --import-from hermes, aynı Plugin geçiş sağlayıcısını kullanır ve uygulamadan önce yine bir önizleme gösterir.

İlgili konular

• 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 sistem durumu denetimi.
• Plugin'ler: Plugin kurulumu ve kaydı.