> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# माइग्रेशन मार्गदर्शिका

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

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

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

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

  <Card title="Hermes से माइग्रेट करना" href="/hi/install/migrating-hermes" icon="feather">
    Hermes कॉन्फिग, प्रदाता, MCP सर्वर, मेमोरी, Skills, और समर्थित `.env` कुंजियां आयात करें।
  </Card>
</CardGroup>

CLI प्रवेश बिंदु [`openclaw migrate`](/hi/cli/migrate) है। Onboarding किसी ज्ञात स्रोत का पता लगाने पर माइग्रेशन भी पेश कर सकता है (`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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway stop
    cd ~
    tar -czf openclaw-state.tgz .openclaw
    ```

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

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

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

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    cd ~
    tar -xzf openclaw-state.tgz
    ```

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

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

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw doctor
    openclaw gateway restart
    openclaw status
    ```
  </Step>
</Steps>

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

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

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

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

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

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

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

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

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

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

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

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

## किसी Plugin को उसी जगह अपग्रेड करें

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

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

## संबंधित

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