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