Maintenance
माइग्रेशन मार्गदर्शिका
OpenClaw तीन माइग्रेशन पथों का समर्थन करता है: किसी अन्य एजेंट सिस्टम से आयात करना, मौजूदा इंस्टॉलेशन को नई मशीन पर ले जाना, और किसी Plugin को उसी स्थान पर अपग्रेड करना।
किसी अन्य एजेंट सिस्टम से आयात करें
बंडल किए गए माइग्रेशन प्रदाता निर्देश, MCP सर्वर, Skills, मॉडल कॉन्फ़िगरेशन और (ऑप्ट-इन) API कुंजियाँ OpenClaw में लाते हैं। किसी भी बदलाव से पहले योजनाओं का पूर्वावलोकन किया जाता है और रिपोर्ट में सीक्रेट छिपा दिए जाते हैं। स्टैंडअलोन openclaw migrate एक सत्यापित बैकअप द्वारा समर्थित होता है; इसके बजाय नया ऑनबोर्डिंग स्थानीय आर्टिफ़ैक्ट को प्रकाशित करने से पहले उन्हें स्टेज और सत्यापित करता है तथा किसी भी अपरिवर्तनीय बाहरी सक्रियण से पहले कॉन्फ़िगरेशन कमिट करता है।
Claude Code और Claude Desktop की स्थिति आयात करें, जिसमें CLAUDE.md, MCP सर्वर, Skills और प्रोजेक्ट कमांड शामिल हैं।
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 और प्रॉम्प्ट।
माइग्रेशन के चरण
Gateway रोकें और बैकअप लें
पुरानी मशीन पर Gateway रोकें, ताकि कॉपी करते समय फ़ाइलें न बदलें, फिर संग्रह बनाएँ:
openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclawयदि आप एकाधिक प्रोफ़ाइल का उपयोग करते हैं (उदाहरण के लिए ~/.openclaw-work), तो प्रत्येक को अलग-अलग संग्रहित करें।
नई मशीन पर OpenClaw इंस्टॉल करें
नई मशीन पर CLI (और आवश्यकता होने पर Node) इंस्टॉल करें। यदि ऑनबोर्डिंग नया ~/.openclaw/ बनाता है, तो कोई समस्या नहीं है—अगले चरण में आप इसे अधिलेखित कर देंगे।
स्टेट डायरेक्टरी और वर्कस्पेस कॉपी करें
संग्रह को scp, rsync -a या किसी बाहरी ड्राइव के माध्यम से स्थानांतरित करें, फिर उसे निकालें:
cd ~tar -xzf openclaw-state.tgzपुष्टि करें कि छिपी हुई डायरेक्टरी शामिल थीं और फ़ाइल का स्वामित्व उस उपयोगकर्ता से मेल खाता है जो Gateway चलाएगा।
Doctor चलाएँ और सत्यापित करें
कॉन्फ़िगरेशन माइग्रेशन लागू करने और सेवाओं की मरम्मत करने के लिए नई मशीन पर Doctor चलाएँ:
openclaw doctoropenclaw gateway restartopenclaw statusयदि Telegram या Discord डिफ़ॉल्ट एनवायरनमेंट फ़ॉलबैक (TELEGRAM_BOT_TOKEN या DISCORD_BOT_TOKEN) का उपयोग करता है, तो सीक्रेट मान प्रिंट किए बिना सत्यापित करें कि माइग्रेट की गई स्टेट डायरेक्टरी के .env में वे कुंजियाँ मौजूद हैं:
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.envजब किसी सक्षम डिफ़ॉल्ट Telegram या Discord खाते के लिए कोई टोकन कॉन्फ़िगर नहीं होता और संबंधित एनवायरनमेंट वेरिएबल Doctor प्रक्रिया के लिए उपलब्ध नहीं होता, तब openclaw doctor भी चेतावनी देता है।
सामान्य समस्याएँ
प्रोफ़ाइल या स्टेट डायरेक्टरी का मेल न खाना
यदि पुराना Gateway --profile या OPENCLAW_STATE_DIR का उपयोग करता था और नया Gateway इसका उपयोग नहीं करता है, तो चैनल लॉग आउट दिखाई देंगे और सत्र खाली होंगे। Gateway को उसी प्रोफ़ाइल या स्टेट डायरेक्टरी के साथ शुरू करें जिसे आपने माइग्रेट किया था, फिर openclaw doctor दोबारा चलाएँ।
केवल openclaw.json कॉपी करना
केवल कॉन्फ़िगरेशन फ़ाइल पर्याप्त नहीं है। मॉडल प्रमाणीकरण प्रोफ़ाइल agents/<agentId>/agent/auth-profiles.json के अंतर्गत और चैनल तथा प्रदाता की स्थिति credentials/ के अंतर्गत रहती है। हमेशा पूरी स्टेट डायरेक्टरी माइग्रेट करें।
अनुमतियाँ और स्वामित्व
यदि आपने root के रूप में कॉपी की है या उपयोगकर्ता बदला है, तो Gateway क्रेडेंशियल पढ़ने में विफल हो सकता है। सुनिश्चित करें कि स्टेट डायरेक्टरी और वर्कस्पेस का स्वामित्व Gateway चलाने वाले उपयोगकर्ता के पास है।
रिमोट मोड
यदि आपका UI किसी रिमोट Gateway की ओर इंगित करता है, तो सत्र और वर्कस्पेस का स्वामी रिमोट होस्ट होता है। अपने स्थानीय लैपटॉप के बजाय स्वयं Gateway होस्ट को माइग्रेट करें। अक्सर पूछे जाने वाले प्रश्न देखें।
बैकअप में सीक्रेट
स्टेट डायरेक्टरी में प्रमाणीकरण प्रोफ़ाइल, चैनल क्रेडेंशियल और अन्य प्रदाता स्थिति होती है। बैकअप को एन्क्रिप्ट करके संग्रहीत करें, असुरक्षित स्थानांतरण चैनलों से बचें और एक्सपोज़र का संदेह होने पर कुंजियाँ बदलें।
सत्यापन चेकलिस्ट
नई मशीन पर पुष्टि करें:
- [ ]
openclaw statusदिखाता है कि Gateway चल रहा है। - [ ] चैनल अब भी कनेक्ट हैं (दोबारा पेयर करने की आवश्यकता नहीं है)।
- [ ] डैशबोर्ड खुलता है और मौजूदा सत्र दिखाता है।
- [ ] वर्कस्पेस फ़ाइलें (मेमोरी, कॉन्फ़िगरेशन) मौजूद हैं।
किसी Plugin को उसी स्थान पर अपग्रेड करें
उसी स्थान पर किए गए Plugin अपग्रेड समान Plugin आईडी और कॉन्फ़िगरेशन कुंजियों को सुरक्षित रखते हैं, लेकिन डिस्क पर मौजूद स्थिति को वर्तमान लेआउट में ले जा सकते हैं। Plugin-विशिष्ट अपग्रेड गाइड उनके चैनलों के साथ उपलब्ध हैं:
- Matrix माइग्रेशन: एन्क्रिप्टेड स्थिति की पुनर्प्राप्ति सीमाएँ, स्वचालित स्नैपशॉट व्यवहार और मैन्युअल पुनर्प्राप्ति कमांड।
संबंधित
openclaw migrate: क्रॉस-सिस्टम आयात के लिए CLI संदर्भ।- इंस्टॉलेशन का अवलोकन: इंस्टॉलेशन की सभी विधियाँ।
- Doctor: माइग्रेशन के बाद की स्थिति जाँच।
- अनइंस्टॉल करें: OpenClaw को साफ़-सुथरे ढंग से हटाना।
