OpenClaw को नई मशीन पर माइग्रेट करना
यह गाइड OpenClaw Gateway को एक मशीन से दूसरी मशीन पर ऑनबोर्डिंग दोबारा किए बिना माइग्रेट करता है। सैद्धांतिक रूप से माइग्रेशन सरल है:- स्टेट डायरेक्टरी कॉपी करें (
$OPENCLAW_STATE_DIR, डिफ़ॉल्ट:~/.openclaw/) — इसमें विन्यास, प्रमाणीकरण, सत्र, और चैनल स्टेट शामिल होते हैं। - अपनी वर्कस्पेस कॉपी करें (
~/.openclaw/workspace/डिफ़ॉल्ट रूप से) — इसमें आपके एजेंट फ़ाइलें (मेमोरी, प्रॉम्प्ट्स, आदि) शामिल होती हैं।
शुरू करने से पहले (आप क्या माइग्रेट कर रहे हैं)
1. अपनी स्टेट डायरेक्टरी पहचानें
अधिकांश इंस्टॉल डिफ़ॉल्ट का उपयोग करते हैं:- स्टेट डायरेक्टरी:
~/.openclaw/
--profile <name>(अक्सर~/.openclaw-<profile>/बन जाता है)OPENCLAW_STATE_DIR=/some/path
OPENCLAW_STATE_DIR / प्रोफ़ाइल के उल्लेख देखें। यदि आप कई गेटवे चलाते हैं, तो प्रत्येक प्रोफ़ाइल के लिए दोहराएँ।
2. अपनी वर्कस्पेस पहचानें
सामान्य डिफ़ॉल्ट:~/.openclaw/workspace/(अनुशंसित वर्कस्पेस)- आपके द्वारा बनाया गया कोई कस्टम फ़ोल्डर
MEMORY.md, USER.md, और memory/*.md जैसी फ़ाइलें रहती हैं।
3. समझें कि आप क्या सुरक्षित रखेंगे
यदि आप दोनों स्टेट डायरेक्टरी और वर्कस्पेस कॉपी करते हैं, तो आप बनाए रखते हैं:- Gateway विन्यास (
openclaw.json) - प्रमाणीकरण प्रोफ़ाइल / एपीआई कुंजियाँ / OAuth टोकन
- सत्र इतिहास + एजेंट स्टेट
- चैनल स्टेट (जैसे WhatsApp लॉगिन/सत्र)
- आपकी वर्कस्पेस फ़ाइलें (मेमोरी, skills नोट्स, आदि)
- सत्र
- क्रेडेंशियल्स
- चैनल लॉगिन
$OPENCLAW_STATE_DIR के अंतर्गत रहते हैं।
माइग्रेशन चरण (अनुशंसित)
चरण 0 — बैकअप बनाएँ (पुरानी मशीन)
पुरानी मशीन पर, पहले Gateway रोकें ताकि कॉपी के दौरान फ़ाइलें न बदलें:~/.openclaw-main, ~/.openclaw-work), तो प्रत्येक को आर्काइव करें।
चरण 1 — नई मशीन पर OpenClaw इंस्टॉल करें
नई मशीन पर, CLI (और यदि आवश्यक हो तो Node) इंस्टॉल करें:- देखें: Install
~/.openclaw/ बनाती है तो यह ठीक है — आप अगले चरण में इसे ओवरराइट कर देंगे।
चरण 2 — स्टेट डायरेक्टरी + वर्कस्पेस नई मशीन पर कॉपी करें
दोनों कॉपी करें:$OPENCLAW_STATE_DIR(डिफ़ॉल्ट~/.openclaw/)- आपकी वर्कस्पेस (डिफ़ॉल्ट
~/.openclaw/workspace/)
scpटारबॉल्स को ट्रांसफ़र कर एक्सट्रैक्ट करेंrsync -aSSH के माध्यम से- बाहरी ड्राइव
- छिपी हुई डिरेक्टरी शामिल की गई थीं (जैसे
.openclaw/)। - Gateway चलाने वाले उपयोगकर्ता के लिए फ़ाइल स्वामित्व सही है
चरण 3 — Doctor चलाएँ (माइग्रेशन + सेवा मरम्मत)
नई मशीन पर:सामान्य गलतियाँ (और उनसे कैसे बचें)
गलती: प्रोफ़ाइल / स्टेट-डायरेक्टरी असंगति
यदि आपने पुराने Gateway को किसी प्रोफ़ाइल (याOPENCLAW_STATE_DIR) के साथ चलाया था, और नया Gateway किसी अलग प्रोफ़ाइल का उपयोग करता है, तो आपको ऐसे लक्षण दिखेंगे:
- विन्यास परिवर्तन प्रभावी नहीं होते
- चैनल गायब / लॉग आउट
- खाली सत्र इतिहास
गलती: केवल openclaw.json कॉपी करना
openclaw.json पर्याप्त नहीं है। कई प्रदाता स्टेट को यहाँ संग्रहीत करते हैं:
$OPENCLAW_STATE_DIR/credentials/$OPENCLAW_STATE_DIR/agents/<agentId>/...
$OPENCLAW_STATE_DIR फ़ोल्डर माइग्रेट करें।
गलती: अनुमतियाँ / स्वामित्व
यदि आपने root के रूप में कॉपी किया या उपयोगकर्ता बदले, तो Gateway क्रेडेंशियल/सत्र पढ़ने में विफल हो सकता है। समाधान: सुनिश्चित करें कि स्टेट डायरेक्टरी + वर्कस्पेस Gateway चलाने वाले उपयोगकर्ता के स्वामित्व में हों।गलती: रिमोट/लोकल मोड के बीच माइग्रेशन
- यदि आपका UI (WebUI/TUI) किसी रिमोट Gateway की ओर इशारा करता है, तो सत्र स्टोर + वर्कस्पेस रिमोट होस्ट के स्वामित्व में होते हैं।
- अपने लैपटॉप को माइग्रेट करने से रिमोट Gateway की स्टेट स्थानांतरित नहीं होती।
गलती: बैकअप में सीक्रेट्स
$OPENCLAW_STATE_DIR में सीक्रेट्स होते हैं (API keys, OAuth tokens, WhatsApp creds)। बैकअप को प्रोडक्शन सीक्रेट्स की तरह ट्रीट करें:
- एन्क्रिप्टेड रूप में संग्रहीत करें
- असुरक्षित चैनलों पर साझा करने से बचें
- यदि एक्सपोज़र का संदेह हो तो कुंजियाँ रोटेट करें
सत्यापन चेकलिस्ट
नई मशीन पर पुष्टि करें:openclaw statusGateway के चलने को दिखाता है- आपके चैनल अभी भी जुड़े रहते हैं (जैसे WhatsApp को दोबारा पेयर करने की आवश्यकता नहीं होती)।
- डैशबोर्ड खुलता है और मौजूदा सत्र दिखाता है
- आपकी वर्कस्पेस फ़ाइलें (मेमोरी, विन्यास) मौजूद हैं