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

# माइग्रेशन गाइड

# OpenClaw को नई मशीन पर माइग्रेट करना

यह गाइड OpenClaw Gateway को एक मशीन से दूसरी मशीन पर **ऑनबोर्डिंग दोबारा किए बिना** माइग्रेट करता है।

सैद्धांतिक रूप से माइग्रेशन सरल है:

* **स्टेट डायरेक्टरी** कॉपी करें (`$OPENCLAW_STATE_DIR`, डिफ़ॉल्ट: `~/.openclaw/`) — इसमें विन्यास, प्रमाणीकरण, सत्र, और चैनल स्टेट शामिल होते हैं।
* अपनी **वर्कस्पेस** कॉपी करें (`~/.openclaw/workspace/` डिफ़ॉल्ट रूप से) — इसमें आपके एजेंट फ़ाइलें (मेमोरी, प्रॉम्प्ट्स, आदि) शामिल होती हैं।

लेकिन **प्रोफ़ाइल**, **अनुमतियाँ**, और **आंशिक कॉपी** से जुड़ी आम गलतियाँ होती हैं।

## शुरू करने से पहले (आप क्या माइग्रेट कर रहे हैं)

### 1. अपनी स्टेट डायरेक्टरी पहचानें

अधिकांश इंस्टॉल डिफ़ॉल्ट का उपयोग करते हैं:

* **स्टेट डायरेक्टरी:** `~/.openclaw/`

लेकिन यदि आप निम्न का उपयोग करते हैं, तो यह अलग हो सकती है:

* `--profile <name>` (अक्सर `~/.openclaw-<profile>/` बन जाता है)
* `OPENCLAW_STATE_DIR=/some/path`

यदि आप निश्चित नहीं हैं, तो **पुरानी** मशीन पर चलाएँ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw status
```

आउटपुट में `OPENCLAW_STATE_DIR` / प्रोफ़ाइल के उल्लेख देखें। यदि आप कई गेटवे चलाते हैं, तो प्रत्येक प्रोफ़ाइल के लिए दोहराएँ।

### 2. अपनी वर्कस्पेस पहचानें

सामान्य डिफ़ॉल्ट:

* `~/.openclaw/workspace/` (अनुशंसित वर्कस्पेस)
* आपके द्वारा बनाया गया कोई कस्टम फ़ोल्डर

आपकी वर्कस्पेस वह स्थान है जहाँ `MEMORY.md`, `USER.md`, और `memory/*.md` जैसी फ़ाइलें रहती हैं।

### 3. समझें कि आप क्या सुरक्षित रखेंगे

यदि आप **दोनों** स्टेट डायरेक्टरी और वर्कस्पेस कॉपी करते हैं, तो आप बनाए रखते हैं:

* Gateway विन्यास (`openclaw.json`)
* प्रमाणीकरण प्रोफ़ाइल / एपीआई कुंजियाँ / OAuth टोकन
* सत्र इतिहास + एजेंट स्टेट
* चैनल स्टेट (जैसे WhatsApp लॉगिन/सत्र)
* आपकी वर्कस्पेस फ़ाइलें (मेमोरी, skills नोट्स, आदि)

यदि आप **केवल** वर्कस्पेस कॉपी करते हैं (उदा., Git के माध्यम से), तो आप **नहीं** सुरक्षित रखते:

* सत्र
* क्रेडेंशियल्स
* चैनल लॉगिन

ये `$OPENCLAW_STATE_DIR` के अंतर्गत रहते हैं।

## माइग्रेशन चरण (अनुशंसित)

### चरण 0 — बैकअप बनाएँ (पुरानी मशीन)

**पुरानी** मशीन पर, पहले Gateway रोकें ताकि कॉपी के दौरान फ़ाइलें न बदलें:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway stop
```

(वैकल्पिक लेकिन अनुशंसित) स्टेट डायरेक्टरी और वर्कस्पेस को आर्काइव करें:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Adjust paths if you use a profile or custom locations
cd ~
tar -czf openclaw-state.tgz .openclaw

tar -czf openclaw-workspace.tgz .openclaw/workspace
```

यदि आपके पास कई प्रोफ़ाइल/स्टेट डिरेक्टरी हैं (जैसे `~/.openclaw-main`, `~/.openclaw-work`), तो प्रत्येक को आर्काइव करें।

### चरण 1 — नई मशीन पर OpenClaw इंस्टॉल करें

**नई** मशीन पर, CLI (और यदि आवश्यक हो तो Node) इंस्टॉल करें:

* देखें: [Install](/install)

इस चरण पर, यदि ऑनबोर्डिंग एक नया `~/.openclaw/` बनाती है तो यह ठीक है — आप अगले चरण में इसे ओवरराइट कर देंगे।

### चरण 2 — स्टेट डायरेक्टरी + वर्कस्पेस नई मशीन पर कॉपी करें

**दोनों** कॉपी करें:

* `$OPENCLAW_STATE_DIR` (डिफ़ॉल्ट `~/.openclaw/`)
* आपकी वर्कस्पेस (डिफ़ॉल्ट `~/.openclaw/workspace/`)

सामान्य तरीके:

* `scp` टारबॉल्स को ट्रांसफ़र कर एक्सट्रैक्ट करें
* `rsync -a` SSH के माध्यम से
* बाहरी ड्राइव

कॉपी के बाद सुनिश्चित करें:

* छिपी हुई डिरेक्टरी शामिल की गई थीं (जैसे `.openclaw/`)।
* Gateway चलाने वाले उपयोगकर्ता के लिए फ़ाइल स्वामित्व सही है

### चरण 3 — Doctor चलाएँ (माइग्रेशन + सेवा मरम्मत)

**नई** मशीन पर:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor
```

Doctor “सुरक्षित और उबाऊ” कमांड है। यह सेवाओं की मरम्मत करता है, कॉन्फ़िग माइग्रेशन लागू करता है, और असंगतियों के बारे में चेतावनी देता है।

इसके बाद:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway restart
openclaw status
```

## सामान्य गलतियाँ (और उनसे कैसे बचें)

### गलती: प्रोफ़ाइल / स्टेट-डायरेक्टरी असंगति

यदि आपने पुराने Gateway को किसी प्रोफ़ाइल (या `OPENCLAW_STATE_DIR`) के साथ चलाया था, और नया Gateway किसी अलग प्रोफ़ाइल का उपयोग करता है, तो आपको ऐसे लक्षण दिखेंगे:

* विन्यास परिवर्तन प्रभावी नहीं होते
* चैनल गायब / लॉग आउट
* खाली सत्र इतिहास

समाधान: Gateway/सेवा को **उसी** प्रोफ़ाइल/स्टेट डायरेक्टरी के साथ चलाएँ जिसे आपने माइग्रेट किया है, फिर दोबारा चलाएँ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor
```

### गलती: केवल `openclaw.json` कॉपी करना

`openclaw.json` पर्याप्त नहीं है। कई प्रदाता स्टेट को यहाँ संग्रहीत करते हैं:

* `$OPENCLAW_STATE_DIR/credentials/`
* `$OPENCLAW_STATE_DIR/agents/<agentId>/...`

हमेशा पूरी `$OPENCLAW_STATE_DIR` फ़ोल्डर माइग्रेट करें।

### गलती: अनुमतियाँ / स्वामित्व

यदि आपने root के रूप में कॉपी किया या उपयोगकर्ता बदले, तो Gateway क्रेडेंशियल/सत्र पढ़ने में विफल हो सकता है।

समाधान: सुनिश्चित करें कि स्टेट डायरेक्टरी + वर्कस्पेस Gateway चलाने वाले उपयोगकर्ता के स्वामित्व में हों।

### गलती: रिमोट/लोकल मोड के बीच माइग्रेशन

* यदि आपका UI (WebUI/TUI) किसी **रिमोट** Gateway की ओर इशारा करता है, तो सत्र स्टोर + वर्कस्पेस रिमोट होस्ट के स्वामित्व में होते हैं।
* अपने लैपटॉप को माइग्रेट करने से रिमोट Gateway की स्टेट स्थानांतरित नहीं होती।

यदि आप रिमोट मोड में हैं, तो **Gateway होस्ट** को माइग्रेट करें।

### गलती: बैकअप में सीक्रेट्स

`$OPENCLAW_STATE_DIR` में सीक्रेट्स होते हैं (API keys, OAuth tokens, WhatsApp creds)। बैकअप को प्रोडक्शन सीक्रेट्स की तरह ट्रीट करें:

* एन्क्रिप्टेड रूप में संग्रहीत करें
* असुरक्षित चैनलों पर साझा करने से बचें
* यदि एक्सपोज़र का संदेह हो तो कुंजियाँ रोटेट करें

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

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

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

## संबंधित

* [Doctor](/gateway/doctor)
* [Gateway समस्या-निवारण](/gateway/troubleshooting)
* [OpenClaw अपना डेटा कहाँ संग्रहीत करता है?](/help/faq#where-does-openclaw-store-its-data)