मुख्य सामग्री पर जाएं

​
openclaw migrate

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

​
कमांड

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate codex --plugin google-calendar --dry-run
openclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-run
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --plugin google-calendar
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes
​
<provider>
string
किसी पंजीकृत माइग्रेशन प्रदाता का नाम, उदाहरण के लिए hermes। इंस्टॉल किए गए प्रदाता देखने के लिए openclaw migrate list चलाएँ।
​
--dry-run
boolean
योजना बनाएँ और स्थिति बदले बिना बाहर निकलें।
​
--from <path>
string
स्रोत स्थिति निर्देशिका को ओवरराइड करें। Hermes डिफ़ॉल्ट रूप से ~/.hermes का उपयोग करता है।
​
--include-secrets
boolean
समर्थित क्रेडेंशियल बिना संकेत दिए आयात करें। इंटरैक्टिव apply, पहचाने गए auth क्रेडेंशियल आयात करने से पहले पूछता है, जहाँ डिफ़ॉल्ट रूप से हाँ चयनित होता है; गैर-इंटरैक्टिव --yes में इन्हें आयात करने के लिए --include-secrets आवश्यक है।
​
--no-auth-credentials
boolean
इंटरैक्टिव संकेत सहित auth क्रेडेंशियल आयात छोड़ें।
​
--overwrite
boolean
जब योजना conflicts रिपोर्ट करे, तब apply को मौजूदा targets बदलने की अनुमति दें।
​
--yes
boolean
पुष्टिकरण संकेत छोड़ें। गैर-इंटरैक्टिव मोड में आवश्यक।
​
--skill <name>
string
skill नाम या item id द्वारा एक skill copy item चुनें। कई skills माइग्रेट करने के लिए flag दोहराएँ। छोड़े जाने पर, इंटरैक्टिव Codex माइग्रेशन checkbox selector दिखाते हैं और गैर-इंटरैक्टिव माइग्रेशन सभी planned skills रखते हैं।
​
--plugin <name>
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 पर लागू होता है।
​
--verify-plugin-apps
boolean
केवल Codex। native Plugin activation की योजना बनाने से पहले ताज़ा source Codex app-server app/list traversal बाध्य करें। माइग्रेशन planning तेज़ रखने के लिए डिफ़ॉल्ट रूप से बंद।
​
--no-backup
boolean
pre-apply backup छोड़ें। local OpenClaw state मौजूद होने पर --force आवश्यक है।
​
--force
boolean
जब apply अन्यथा backup छोड़ने से मना कर देता, तब --no-backup के साथ आवश्यक।
​
--json
boolean
योजना या apply परिणाम को JSON के रूप में प्रिंट करें। --json और बिना --yes के, apply योजना प्रिंट करता है और state को mutate नहीं करता।

​
सुरक्षा मॉडल

openclaw migrate पहले preview करता है।
प्रदाता कुछ भी बदलने से पहले itemized योजना लौटाता है, जिसमें conflicts, छोड़े गए items, और sensitive items शामिल होते हैं। JSON plans, apply output, और migration reports nested secret-looking keys जैसे API keys, tokens, authorization headers, cookies, और passwords को redact करते हैं।openclaw migrate apply <provider> योजना का preview करता है और state बदलने से पहले संकेत देता है, जब तक --yes सेट न हो। गैर-इंटरैक्टिव मोड में, apply के लिए --yes आवश्यक है।
Apply माइग्रेशन लागू करने से पहले OpenClaw backup बनाता और verify करता है। अगर अभी तक कोई local OpenClaw state मौजूद नहीं है, तो backup step छोड़ा जाता है और माइग्रेशन जारी रह सकता है। state मौजूद होने पर backup छोड़ने के लिए, --no-backup और --force दोनों पास करें।
जब योजना में conflicts हों तो apply जारी रखने से मना कर देता है। योजना की समीक्षा करें, फिर अगर मौजूदा targets बदलना जानबूझकर है तो --overwrite के साथ फिर चलाएँ। Providers अभी भी migration report directory में overwritten files के लिए item-level backups लिख सकते हैं।
इंटरैक्टिव apply पूछता है कि पहचाने गए auth credentials आयात करने हैं या नहीं, जहाँ डिफ़ॉल्ट रूप से हाँ चयनित होता है। उन्हें छोड़ने के लिए --no-auth-credentials का उपयोग करें, या --yes के साथ unattended credential import के लिए --include-secrets का उपयोग करें।

​
Claude प्रदाता

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

​
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-workspace
openclaw 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-calendar
openclaw 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 दिखाते हैं।
Onboarding imports के लिए fresh OpenClaw setup आवश्यक है। यदि आपके पास पहले से local state है, तो पहले config, credentials, sessions, और workspace reset करें। Backup-plus-overwrite या merge imports existing setups के लिए feature-gated हैं।