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

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

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

Claude से माइग्रेट करना

Claude Code और Claude Desktop की स्थिति आयात करें, जिसमें CLAUDE.md, MCP सर्वर, Skills और प्रोजेक्ट कमांड शामिल हैं।

Hermes से माइग्रेट करना

Hermes कॉन्फ़िगरेशन, प्रदाता, MCP सर्वर, मेमोरी, Skills और समर्थित .env कुंजियाँ आयात करें।
CLI प्रवेश बिंदु openclaw migrate है। किसी ज्ञात स्रोत (openclaw onboard --flow import) का पता चलने पर ऑनबोर्डिंग भी माइग्रेशन की पेशकश कर सकता है।

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

इन्हें सुरक्षित रखने के लिए स्टेट डायरेक्टरी (डिफ़ॉल्ट रूप से ~/.openclaw/) और अपने वर्कस्पेस को कॉपी करें:
  • कॉन्फ़िगरेशन — openclaw.json और सभी Gateway सेटिंग।
  • प्रमाणीकरण — प्रति-एजेंट auth-profiles.json (API कुंजियाँ और OAuth), साथ ही credentials/ के अंतर्गत कोई भी चैनल या प्रदाता स्थिति।
  • सत्र — वार्तालाप इतिहास और एजेंट की स्थिति।
  • चैनल की स्थिति — WhatsApp लॉगिन, Telegram सत्र और ऐसी ही अन्य चीज़ें।
  • वर्कस्पेस फ़ाइलें — MEMORY.md, USER.md, Skills और प्रॉम्प्ट।
अपनी स्टेट डायरेक्टरी के पथ की पुष्टि करने के लिए पुरानी मशीन पर openclaw status चलाएँ। कस्टम प्रोफ़ाइल ~/.openclaw-<profile>/ या OPENCLAW_STATE_DIR के माध्यम से निर्धारित पथ का उपयोग करती हैं।

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

1

Gateway रोकें और बैकअप लें

पुरानी मशीन पर Gateway रोकें, ताकि कॉपी करते समय फ़ाइलें न बदलें, फिर संग्रह बनाएँ:
यदि आप एकाधिक प्रोफ़ाइल का उपयोग करते हैं (उदाहरण के लिए ~/.openclaw-work), तो प्रत्येक को अलग-अलग संग्रहित करें।
2

नई मशीन पर OpenClaw इंस्टॉल करें

नई मशीन पर CLI (और आवश्यकता होने पर Node) इंस्टॉल करें। यदि ऑनबोर्डिंग नया ~/.openclaw/ बनाता है, तो कोई समस्या नहीं है—अगले चरण में आप इसे अधिलेखित कर देंगे।
3

स्टेट डायरेक्टरी और वर्कस्पेस कॉपी करें

संग्रह को scp, rsync -a या किसी बाहरी ड्राइव के माध्यम से स्थानांतरित करें, फिर उसे निकालें:
पुष्टि करें कि छिपी हुई डायरेक्टरी शामिल थीं और फ़ाइल का स्वामित्व उस उपयोगकर्ता से मेल खाता है जो Gateway चलाएगा।
4

Doctor चलाएँ और सत्यापित करें

कॉन्फ़िगरेशन माइग्रेशन लागू करने और सेवाओं की मरम्मत करने के लिए नई मशीन पर Doctor चलाएँ:
यदि Telegram या Discord डिफ़ॉल्ट एनवायरनमेंट फ़ॉलबैक (TELEGRAM_BOT_TOKEN या DISCORD_BOT_TOKEN) का उपयोग करता है, तो सीक्रेट मान प्रिंट किए बिना सत्यापित करें कि माइग्रेट की गई स्टेट डायरेक्टरी के .env में वे कुंजियाँ मौजूद हैं:
जब किसी सक्षम डिफ़ॉल्ट Telegram या Discord खाते के लिए कोई टोकन कॉन्फ़िगर नहीं होता और संबंधित एनवायरनमेंट वेरिएबल Doctor प्रक्रिया के लिए उपलब्ध नहीं होता, तब openclaw doctor भी चेतावनी देता है।

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

यदि पुराना Gateway --profile या OPENCLAW_STATE_DIR का उपयोग करता था और नया Gateway इसका उपयोग नहीं करता है, तो चैनल लॉग आउट दिखाई देंगे और सत्र खाली होंगे। Gateway को उसी प्रोफ़ाइल या स्टेट डायरेक्टरी के साथ शुरू करें जिसे आपने माइग्रेट किया था, फिर openclaw doctor दोबारा चलाएँ।
केवल कॉन्फ़िगरेशन फ़ाइल पर्याप्त नहीं है। मॉडल प्रमाणीकरण प्रोफ़ाइल agents/<agentId>/agent/auth-profiles.json के अंतर्गत और चैनल तथा प्रदाता की स्थिति credentials/ के अंतर्गत रहती है। हमेशा पूरी स्टेट डायरेक्टरी माइग्रेट करें।
यदि आपने root के रूप में कॉपी की है या उपयोगकर्ता बदला है, तो Gateway क्रेडेंशियल पढ़ने में विफल हो सकता है। सुनिश्चित करें कि स्टेट डायरेक्टरी और वर्कस्पेस का स्वामित्व Gateway चलाने वाले उपयोगकर्ता के पास है।
यदि आपका UI किसी रिमोट Gateway की ओर इंगित करता है, तो सत्र और वर्कस्पेस का स्वामी रिमोट होस्ट होता है। अपने स्थानीय लैपटॉप के बजाय स्वयं Gateway होस्ट को माइग्रेट करें। अक्सर पूछे जाने वाले प्रश्न देखें।
स्टेट डायरेक्टरी में प्रमाणीकरण प्रोफ़ाइल, चैनल क्रेडेंशियल और अन्य प्रदाता स्थिति होती है। बैकअप को एन्क्रिप्ट करके संग्रहीत करें, असुरक्षित स्थानांतरण चैनलों से बचें और एक्सपोज़र का संदेह होने पर कुंजियाँ बदलें।

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

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

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

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

​
संबंधित