openclaw migrate

Plugin-स्वामित्व वाले माइग्रेशन प्रदाता के माध्यम से किसी दूसरे एजेंट सिस्टम से स्थिति आयात करें। बंडल किए गए प्रदाता Codex CLI स्थिति, Claude, और Hermes को कवर करते हैं; तृतीय-पक्ष plugins अतिरिक्त प्रदाता पंजीकृत कर सकते हैं।

कमांड

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> किसी पंजीकृत माइग्रेशन प्रदाता का नाम, उदाहरण के लिए hermes। इंस्टॉल किए गए प्रदाता देखने के लिए openclaw migrate list चलाएँ।

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> स्रोत स्थिति निर्देशिका को ओवरराइड करें। Hermes डिफ़ॉल्ट रूप से ~/.hermes का उपयोग करता है।

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> Plugin नाम या item id द्वारा एक Codex Plugin install item चुनें। कई Codex plugins माइग्रेट करने के लिए flag दोहराएँ। छोड़े जाने पर, इंटरैक्टिव Codex माइग्रेशन native Codex Plugin checkbox selector दिखाते हैं और गैर-इंटरैक्टिव माइग्रेशन सभी planned plugins रखते हैं। यह केवल Codex app-server inventory द्वारा खोजे गए source-installed openai-curated Codex plugins पर लागू होता है।

सुरक्षा मॉडल

openclaw migrate पहले preview करता है।

Claude प्रदाता

बंडल किया गया Claude प्रदाता डिफ़ॉल्ट रूप से ~/.claude पर Claude Code state पहचानता है। किसी विशिष्ट Claude Code home या project root को आयात करने के लिए --from <path> का उपयोग करें।

Claude क्या आयात करता है

• Project CLAUDE.md और .claude/CLAUDE.md को OpenClaw एजेंट workspace में।
• User ~/.claude/CLAUDE.md को workspace USER.md में append किया गया।
• project .mcp.json, Claude Code ~/.claude.json, और Claude Desktop claude_desktop_config.json से MCP server definitions।
• Claude skill directories जिनमें SKILL.md शामिल है।
• Claude command Markdown files को केवल manual invocation वाले OpenClaw skills में परिवर्तित किया गया।

Archive और manual-review state

Claude hooks, permissions, environment defaults, local memory, path-scoped rules, subagents, caches, plans, और project history को migration report में सुरक्षित रखा जाता है या manual-review items के रूप में रिपोर्ट किया जाता है। OpenClaw hooks execute नहीं करता, broad allowlists copy नहीं करता, या OAuth/Desktop credential state को अपने-आप import नहीं करता।

Codex प्रदाता

बंडल किया गया Codex प्रदाता डिफ़ॉल्ट रूप से ~/.codex पर Codex CLI state पहचानता है, या जब वह environment variable set हो तो CODEX_HOME पर। किसी विशिष्ट Codex home का inventory लेने के लिए --from <path> का उपयोग करें।

इस प्रदाता का उपयोग तब करें जब आप OpenClaw Codex harness पर जा रहे हों और उपयोगी personal Codex CLI assets को सोच-समझकर promote करना चाहते हों। Local Codex app-server launches per-agent CODEX_HOME का उपयोग करते हैं, इसलिए वे डिफ़ॉल्ट रूप से आपके personal ~/.codex को नहीं पढ़ते। सामान्य process HOME अब भी inherited होता है, इसलिए Codex shared $HOME/.agents/* skills/plugin marketplace entries देख सकता है और subprocesses user-home config और tokens खोज सकते हैं।

Interactive terminal में openclaw migrate codex चलाने पर full plan का preview होता है, फिर final apply confirmation से पहले checkbox selectors खुलते हैं। Skill copy items पहले prompt किए जाते हैं। Bulk selection के लिए Toggle all on या Toggle all off का उपयोग करें। Rows toggle करने के लिए Space दबाएँ, या highlighted row activate करके जारी रखने के लिए Enter दबाएँ। Planned skills checked शुरू होते हैं, conflict skills unchecked शुरू होते हैं, और Skip for now इस run के लिए skill copies छोड़ देता है, जबकि plugin selection जारी रहता है। जब source-installed curated Codex plugins migratable हों और --plugin supplied न हो, तो migration फिर Plugin name द्वारा native Codex Plugin activation के लिए prompt करता है। Plugin items checked शुरू होते हैं जब तक target OpenClaw Codex Plugin config में वह Plugin पहले से न हो। मौजूदा target plugins unchecked शुरू होते हैं और conflict: plugin exists जैसा conflict hint दिखाते हैं; उस run में कोई native Codex plugins migrate न करने के लिए Toggle all off चुनें, या applying से पहले रुकने के लिए Skip for now चुनें। Scripted या exact runs के लिए, प्रति skill एक बार --skill <name> पास करें, उदाहरण के लिए:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --skill gog-vault77-google-workspace

Native Codex Plugin migration को non-interactively एक या अधिक source-installed curated plugins तक सीमित करने के लिए --plugin <name> का उपयोग करें:

openclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

Codex क्या आयात करता है

• $CODEX_HOME/skills के अंतर्गत Codex CLI skill directories, Codex के .system cache को छोड़कर।
• $HOME/.agents/skills के अंतर्गत personal AgentSkills, जब आप per-agent ownership चाहते हैं तो current OpenClaw agent workspace में copy किए जाते हैं।
• Codex app-server plugin/list के माध्यम से खोजे गए source-installed openai-curated Codex plugins। Planning हर enabled installed Plugin के लिए plugin/read पढ़ता है। App-backed plugins के लिए source Codex app-server account response का ChatGPT subscription account होना आवश्यक है; non-ChatGPT या missing account responses को codex_subscription_required के साथ skip किया जाता है। डिफ़ॉल्ट रूप से, migration source app/list call नहीं करता, इसलिए account gate पास करने वाले app-backed plugins source app accessibility verification के बिना planned होते हैं, और account lookup transport failures codex_account_unavailable के साथ skip होते हैं। जब आप migration से ताज़ा source app/list snapshot force कराना चाहते हों और native activation plan करने से पहले हर owned app का present, enabled, और accessible होना require करना चाहते हों, तब --verify-plugin-apps पास करें। उस mode में, account lookup transport failures source app inventory verification में fall through करते हैं। Current process के लिए source app inventory snapshot memory में रखा जाता है; इसे migration output या target config में नहीं लिखा जाता। Disabled plugins, unreadable Plugin details, subscription-gated source accounts, और, जब verification requested हो, missing apps, disabled apps, inaccessible apps, या source app inventory failures target config entries के बजाय typed reasons वाले manual skipped items बनते हैं। Apply हर selected eligible Plugin के लिए app-server plugin/install call करता है, भले ही target app-server पहले से उस Plugin को installed और enabled रिपोर्ट करे। Migrated Codex plugins केवल उन sessions में usable होते हैं जो native Codex harness चुनते हैं; उन्हें OpenClaw provider runs, ACP conversation bindings, या अन्य harnesses के लिए expose नहीं किया जाता।

Manual-review Codex state

Codex config.toml, native hooks/hooks.json, non-curated marketplaces, cached Plugin bundles जो source-installed curated plugins नहीं हैं, और source-installed plugins जो source subscription gate fail करते हैं, automatically activated नहीं होते। जब --verify-plugin-apps set हो, तो source app-inventory gate fail करने वाले plugins भी skip किए जाते हैं। उन्हें manual review के लिए migration report में copy या report किया जाता है।

Migrated source-installed curated plugins के लिए, apply लिखता है:

• plugins.entries.codex.enabled: true
• plugins.entries.codex.config.codexPlugins.enabled: true
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
• हर selected Plugin के लिए marketplaceName: "openai-curated" और pluginName वाली एक explicit Plugin entry

माइग्रेशन कभी भी plugins["*"] नहीं लिखता और स्थानीय marketplace cache paths कभी संग्रहित नहीं करता। स्रोत-पक्ष subscription विफलताएं manual items पर typed reasons जैसे codex_subscription_required, codex_account_unavailable, plugin_disabled, या plugin_read_unavailable के साथ रिपोर्ट की जाती हैं। --verify-plugin-apps के साथ, source app-inventory विफलताएं app_inaccessible, app_disabled, app_missing, या app_inventory_unavailable के रूप में भी दिखाई दे सकती हैं। छोड़े गए plugins target config में नहीं लिखे जाते। Target-पक्ष auth-required installs प्रभावित plugin item पर status: "skipped", reason: "auth_required", और sanitized app identifiers के साथ रिपोर्ट किए जाते हैं। उनकी explicit config entries तब तक disabled लिखी जाती हैं जब तक आप उन्हें फिर से authorize और enable नहीं करते। अन्य install विफलताएं item-scoped error results होती हैं।

यदि planning के दौरान Codex app-server plugin inventory अनुपलब्ध है, तो migration पूरे migration को विफल करने के बजाय cached bundle advisory items पर fallback करता है।

Hermes प्रदाता

Bundled Hermes प्रदाता default रूप से ~/.hermes पर state detect करता है। जब Hermes कहीं और हो, तो --from <path> का उपयोग करें।

Hermes क्या import करता है

• config.yaml से default model configuration।
• providers और custom_providers से configured model providers और custom OpenAI-compatible endpoints।
• mcp_servers या mcp.servers से MCP server definitions।
• OpenClaw agent workspace में SOUL.md और AGENTS.md।
• Workspace memory files में append किए गए memories/MEMORY.md और memories/USER.md।
• OpenClaw file memory के लिए memory config defaults, साथ ही Honcho जैसे external memory providers के लिए archive या manual-review items।
• वे Skills जिनमें skills/<name>/ के अंतर्गत SKILL.md file शामिल है।
• skills.config से per-skill config values।
• OpenCode auth.json से OpenCode OpenAI OAuth credentials, जब interactive credential migration स्वीकार किया जाता है, या जब --include-secrets set होता है। Hermes auth.json OAuth entries legacy state हैं जिन्हें manual OpenAI reauth या doctor repair के लिए report किया जाता है।
• Hermes .env और OpenCode auth.json से supported API keys और tokens, जब interactive credential migration स्वीकार किया जाता है, या जब --include-secrets set होता है।

Supported .env keys

• 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

Archive-only state

Hermes state जिसे OpenClaw सुरक्षित रूप से interpret नहीं कर सकता, manual review के लिए migration report में copy किया जाता है, लेकिन इसे live OpenClaw config या credentials में load नहीं किया जाता। यह opaque या unsafe state को सुरक्षित रखता है, बिना यह दिखावा किए कि OpenClaw उसे automatically execute या trust कर सकता है:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• state.db

Apply करने के बाद

openclaw doctor

Plugin contract

Migration sources plugins हैं। कोई plugin openclaw.plugin.json में अपने provider ids declare करता है:

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

Runtime पर plugin api.registerMigrationProvider(...) call करता है। Provider detect, plan, और apply implement करता है। Core CLI orchestration, backup policy, prompts, JSON output, और conflict preflight का owner है। Core reviewed plan को apply(ctx, plan) में pass करता है, और providers compatibility के लिए plan को केवल तभी rebuild कर सकते हैं जब वह argument absent हो।

Provider plugins item construction और summary counts के लिए openclaw/plugin-sdk/migration, साथ ही conflict-aware file copies, archive-only report copies, cached config-runtime wrappers, और migration reports के लिए openclaw/plugin-sdk/migration-runtime का उपयोग कर सकते हैं।

Onboarding integration

जब कोई provider known source detect करता है, तो onboarding migration offer कर सकती है। openclaw onboard --flow import और openclaw setup --wizard --import-from hermes दोनों वही plugin migration provider उपयोग करते हैं और apply करने से पहले अभी भी preview दिखाते हैं।

Related

• Hermes से migration: user-facing walkthrough।
• Claude से migration: user-facing walkthrough।
• Migrating: OpenClaw को नई machine पर move करें।
• Doctor: migration apply करने के बाद health check।
• Plugins: plugin install और registration।