---
read_when:
    - आप OpenClaw को नए लैपटॉप या सर्वर पर स्थानांतरित कर रहे हैं
    - आप किसी अन्य एजेंट सिस्टम से आ रहे हैं और स्थिति बनाए रखना चाहते हैं
    - आप किसी मौजूदा Plugin को अपग्रेड कर रहे हैं
summary: 'माइग्रेशन केंद्र: विभिन्न प्रणालियों के बीच आयात, मशीन-से-मशीन स्थानांतरण और Plugin अपग्रेड'
title: माइग्रेशन मार्गदर्शिका
x-i18n:
    generated_at: "2026-07-27T20:01:39Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: e9ceb80045ab082c9cfc9e1aca59e079b6bf28b1d047265a0be40c03ebe5dac6
    source_path: install/migrating.md
    workflow: 16
---

OpenClaw तीन माइग्रेशन पथों का समर्थन करता है: किसी अन्य एजेंट सिस्टम से आयात करना, मौजूदा इंस्टॉलेशन को नई मशीन पर ले जाना, और किसी Plugin को उसी स्थान पर अपग्रेड करना।

## किसी अन्य एजेंट सिस्टम से आयात करें

बंडल किए गए माइग्रेशन प्रदाता निर्देश, MCP सर्वर, Skills, मॉडल कॉन्फ़िगरेशन और (ऑप्ट-इन) API कुंजियाँ OpenClaw में लाते हैं। किसी भी बदलाव से पहले योजनाओं का पूर्वावलोकन किया जाता है और रिपोर्ट में सीक्रेट छिपा दिए जाते हैं। स्टैंडअलोन `openclaw migrate` एक सत्यापित बैकअप द्वारा समर्थित होता है; इसके बजाय नया ऑनबोर्डिंग स्थानीय आर्टिफ़ैक्ट को प्रकाशित करने से पहले उन्हें स्टेज और सत्यापित करता है तथा किसी भी अपरिवर्तनीय बाहरी सक्रियण से पहले कॉन्फ़िगरेशन कमिट करता है।

<CardGroup cols={2}>
  <Card title="Claude से माइग्रेट करना" href="/hi/install/migrating-claude" icon="brain">
    Claude Code और Claude Desktop की स्थिति आयात करें, जिसमें `CLAUDE.md`, MCP सर्वर, Skills और प्रोजेक्ट कमांड शामिल हैं।
  </Card>
  <Card title="Hermes से माइग्रेट करना" href="/hi/install/migrating-hermes" icon="feather">
    Hermes कॉन्फ़िगरेशन, प्रदाता, MCP सर्वर, मेमोरी, Skills और समर्थित `.env` कुंजियाँ आयात करें।
  </Card>
</CardGroup>

CLI प्रवेश बिंदु [`openclaw migrate`](/hi/cli/migrate) है। किसी ज्ञात स्रोत (`openclaw onboard --flow import`) का पता चलने पर ऑनबोर्डिंग भी माइग्रेशन की पेशकश कर सकता है।

## OpenClaw को नई मशीन पर ले जाएँ

इन्हें सुरक्षित रखने के लिए **स्टेट डायरेक्टरी** (डिफ़ॉल्ट रूप से `~/.openclaw/`) और अपने **वर्कस्पेस** को कॉपी करें:

- **कॉन्फ़िगरेशन** — `openclaw.json` और सभी Gateway सेटिंग।
- **प्रमाणीकरण** — प्रति-एजेंट `auth-profiles.json` (API कुंजियाँ और OAuth), साथ ही `credentials/` के अंतर्गत कोई भी चैनल या प्रदाता स्थिति।
- **सत्र** — वार्तालाप इतिहास और एजेंट की स्थिति।
- **चैनल की स्थिति** — WhatsApp लॉगिन, Telegram सत्र और ऐसी ही अन्य चीज़ें।
- **वर्कस्पेस फ़ाइलें** — `MEMORY.md`, `USER.md`, Skills और प्रॉम्प्ट।

<Tip>
अपनी स्टेट डायरेक्टरी के पथ की पुष्टि करने के लिए पुरानी मशीन पर `openclaw status` चलाएँ। कस्टम प्रोफ़ाइल `~/.openclaw-<profile>/` या `OPENCLAW_STATE_DIR` के माध्यम से निर्धारित पथ का उपयोग करती हैं।
</Tip>

### माइग्रेशन के चरण

<Steps>
  <Step title="Gateway रोकें और बैकअप लें">
    **पुरानी** मशीन पर Gateway रोकें, ताकि कॉपी करते समय फ़ाइलें न बदलें, फिर संग्रह बनाएँ:

    ```bash
    openclaw gateway stop
    cd ~
    tar -czf openclaw-state.tgz .openclaw
    ```

    यदि आप एकाधिक प्रोफ़ाइल का उपयोग करते हैं (उदाहरण के लिए `~/.openclaw-work`), तो प्रत्येक को अलग-अलग संग्रहित करें।

  </Step>

  <Step title="नई मशीन पर OpenClaw इंस्टॉल करें">
    नई मशीन पर CLI (और आवश्यकता होने पर Node) [इंस्टॉल करें](/hi/install)। यदि ऑनबोर्डिंग नया `~/.openclaw/` बनाता है, तो कोई समस्या नहीं है—अगले चरण में आप इसे अधिलेखित कर देंगे।
  </Step>

  <Step title="स्टेट डायरेक्टरी और वर्कस्पेस कॉपी करें">
    संग्रह को `scp`, `rsync -a` या किसी बाहरी ड्राइव के माध्यम से स्थानांतरित करें, फिर उसे निकालें:

    ```bash
    cd ~
    tar -xzf openclaw-state.tgz
    ```

    पुष्टि करें कि छिपी हुई डायरेक्टरी शामिल थीं और फ़ाइल का स्वामित्व उस उपयोगकर्ता से मेल खाता है जो Gateway चलाएगा।

  </Step>

  <Step title="Doctor चलाएँ और सत्यापित करें">
    कॉन्फ़िगरेशन माइग्रेशन लागू करने और सेवाओं की मरम्मत करने के लिए नई मशीन पर [Doctor](/hi/gateway/doctor) चलाएँ:

    ```bash
    openclaw doctor
    openclaw gateway restart
    openclaw status
    ```

  </Step>
</Steps>

यदि Telegram या Discord डिफ़ॉल्ट एनवायरनमेंट फ़ॉलबैक (`TELEGRAM_BOT_TOKEN` या `DISCORD_BOT_TOKEN`) का उपयोग करता है, तो सीक्रेट मान प्रिंट किए बिना सत्यापित करें कि माइग्रेट की गई स्टेट डायरेक्टरी के `.env` में वे कुंजियाँ मौजूद हैं:

```bash
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env
```

जब किसी सक्षम डिफ़ॉल्ट Telegram या Discord खाते के लिए कोई टोकन कॉन्फ़िगर नहीं होता और संबंधित एनवायरनमेंट वेरिएबल Doctor प्रक्रिया के लिए उपलब्ध नहीं होता, तब `openclaw doctor` भी चेतावनी देता है।

### सामान्य समस्याएँ

<AccordionGroup>
  <Accordion title="प्रोफ़ाइल या स्टेट डायरेक्टरी का मेल न खाना">
    यदि पुराना Gateway `--profile` या `OPENCLAW_STATE_DIR` का उपयोग करता था और नया Gateway इसका उपयोग नहीं करता है, तो चैनल लॉग आउट दिखाई देंगे और सत्र खाली होंगे। Gateway को उसी प्रोफ़ाइल या स्टेट डायरेक्टरी के साथ शुरू करें जिसे आपने माइग्रेट किया था, फिर `openclaw doctor` दोबारा चलाएँ।
  </Accordion>

  <Accordion title="केवल openclaw.json कॉपी करना">
    केवल कॉन्फ़िगरेशन फ़ाइल पर्याप्त नहीं है। मॉडल प्रमाणीकरण प्रोफ़ाइल `agents/<agentId>/agent/auth-profiles.json` के अंतर्गत और चैनल तथा प्रदाता की स्थिति `credentials/` के अंतर्गत रहती है। हमेशा **पूरी** स्टेट डायरेक्टरी माइग्रेट करें।
  </Accordion>

  <Accordion title="अनुमतियाँ और स्वामित्व">
    यदि आपने root के रूप में कॉपी की है या उपयोगकर्ता बदला है, तो Gateway क्रेडेंशियल पढ़ने में विफल हो सकता है। सुनिश्चित करें कि स्टेट डायरेक्टरी और वर्कस्पेस का स्वामित्व Gateway चलाने वाले उपयोगकर्ता के पास है।
  </Accordion>

  <Accordion title="रिमोट मोड">
    यदि आपका UI किसी **रिमोट** Gateway की ओर इंगित करता है, तो सत्र और वर्कस्पेस का स्वामी रिमोट होस्ट होता है। अपने स्थानीय लैपटॉप के बजाय स्वयं Gateway होस्ट को माइग्रेट करें। [अक्सर पूछे जाने वाले प्रश्न](/hi/help/faq#where-things-live-on-disk) देखें।
  </Accordion>

  <Accordion title="बैकअप में सीक्रेट">
    स्टेट डायरेक्टरी में प्रमाणीकरण प्रोफ़ाइल, चैनल क्रेडेंशियल और अन्य प्रदाता स्थिति होती है। बैकअप को एन्क्रिप्ट करके संग्रहीत करें, असुरक्षित स्थानांतरण चैनलों से बचें और एक्सपोज़र का संदेह होने पर कुंजियाँ बदलें।
  </Accordion>
</AccordionGroup>

### सत्यापन चेकलिस्ट

नई मशीन पर पुष्टि करें:

- [ ] `openclaw status` दिखाता है कि Gateway चल रहा है।
- [ ] चैनल अब भी कनेक्ट हैं (दोबारा पेयर करने की आवश्यकता नहीं है)।
- [ ] डैशबोर्ड खुलता है और मौजूदा सत्र दिखाता है।
- [ ] वर्कस्पेस फ़ाइलें (मेमोरी, कॉन्फ़िगरेशन) मौजूद हैं।

## किसी Plugin को उसी स्थान पर अपग्रेड करें

उसी स्थान पर किए गए Plugin अपग्रेड समान Plugin आईडी और कॉन्फ़िगरेशन कुंजियों को सुरक्षित रखते हैं, लेकिन डिस्क पर मौजूद स्थिति को वर्तमान लेआउट में ले जा सकते हैं। Plugin-विशिष्ट अपग्रेड गाइड उनके चैनलों के साथ उपलब्ध हैं:

- [Matrix माइग्रेशन](/hi/channels/matrix-migration): एन्क्रिप्टेड स्थिति की पुनर्प्राप्ति सीमाएँ, स्वचालित स्नैपशॉट व्यवहार और मैन्युअल पुनर्प्राप्ति कमांड।

## संबंधित

- [`openclaw migrate`](/hi/cli/migrate): क्रॉस-सिस्टम आयात के लिए CLI संदर्भ।
- [इंस्टॉलेशन का अवलोकन](/hi/install): इंस्टॉलेशन की सभी विधियाँ।
- [Doctor](/hi/gateway/doctor): माइग्रेशन के बाद की स्थिति जाँच।
- [अनइंस्टॉल करें](/hi/install/uninstall): OpenClaw को साफ़-सुथरे ढंग से हटाना।