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

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

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

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

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

अधिकांश इंस्टॉल डिफ़ॉल्ट का उपयोग करते हैं:
  • स्टेट डायरेक्टरी: ~/.openclaw/
लेकिन यदि आप निम्न का उपयोग करते हैं, तो यह अलग हो सकती है:
  • --profile <name> (अक्सर ~/.openclaw-<profile>/ बन जाता है)
  • OPENCLAW_STATE_DIR=/some/path
यदि आप निश्चित नहीं हैं, तो पुरानी मशीन पर चलाएँ: 
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 रोकें ताकि कॉपी के दौरान फ़ाइलें न बदलें: 
openclaw gateway stop
(वैकल्पिक लेकिन अनुशंसित) स्टेट डायरेक्टरी और वर्कस्पेस को आर्काइव करें: 
# 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) इंस्टॉल करें: इस चरण पर, यदि ऑनबोर्डिंग एक नया ~/.openclaw/ बनाती है तो यह ठीक है — आप अगले चरण में इसे ओवरराइट कर देंगे।

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

दोनों कॉपी करें:
  • $OPENCLAW_STATE_DIR (डिफ़ॉल्ट ~/.openclaw/)
  • आपकी वर्कस्पेस (डिफ़ॉल्ट ~/.openclaw/workspace/)
सामान्य तरीके:
  • scp टारबॉल्स को ट्रांसफ़र कर एक्सट्रैक्ट करें
  • rsync -a SSH के माध्यम से
  • बाहरी ड्राइव
कॉपी के बाद सुनिश्चित करें:
  • छिपी हुई डिरेक्टरी शामिल की गई थीं (जैसे .openclaw/)।
  • Gateway चलाने वाले उपयोगकर्ता के लिए फ़ाइल स्वामित्व सही है

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

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

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

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

यदि आपने पुराने Gateway को किसी प्रोफ़ाइल (या OPENCLAW_STATE_DIR) के साथ चलाया था, और नया Gateway किसी अलग प्रोफ़ाइल का उपयोग करता है, तो आपको ऐसे लक्षण दिखेंगे:
  • विन्यास परिवर्तन प्रभावी नहीं होते
  • चैनल गायब / लॉग आउट
  • खाली सत्र इतिहास
समाधान: Gateway/सेवा को उसी प्रोफ़ाइल/स्टेट डायरेक्टरी के साथ चलाएँ जिसे आपने माइग्रेट किया है, फिर दोबारा चलाएँ: 
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 को दोबारा पेयर करने की आवश्यकता नहीं होती)।
  • डैशबोर्ड खुलता है और मौजूदा सत्र दिखाता है
  • आपकी वर्कस्पेस फ़ाइलें (मेमोरी, विन्यास) मौजूद हैं

​
संबंधित