openclaw backup

OpenClaw स्थिति, कॉन्फ़िग, ऑथ प्रोफ़ाइल, चैनल/प्रदाता क्रेडेंशियल, सेशन, और वैकल्पिक रूप से वर्कस्पेस के लिए एक स्थानीय बैकअप आर्काइव बनाएँ।

openclaw backup createopenclaw backup create --output ~/Backupsopenclaw backup create --dry-run --jsonopenclaw backup create --verifyopenclaw backup create --no-include-workspaceopenclaw backup create --only-configopenclaw backup verify ./2026-03-09T08-00-00.000+08-00-openclaw-backup.tar.gz

नोट्स

• आर्काइव में हल किए गए स्रोत पथों और आर्काइव लेआउट के साथ एक manifest.json फ़ाइल शामिल होती है।
• डिफ़ॉल्ट आउटपुट वर्तमान कार्यशील डायरेक्टरी में टाइमस्टैम्प वाला .tar.gz आर्काइव होता है।
• टाइमस्टैम्प वाले बैकअप फ़ाइलनाम आपकी मशीन के स्थानीय टाइमज़ोन का उपयोग करते हैं और UTC ऑफ़सेट शामिल करते हैं।
• अगर वर्तमान कार्यशील डायरेक्टरी किसी बैकअप किए गए स्रोत ट्री के अंदर है, तो OpenClaw डिफ़ॉल्ट आर्काइव स्थान के लिए आपकी होम डायरेक्टरी पर वापस जाता है।
• मौजूदा आर्काइव फ़ाइलें कभी ओवरराइट नहीं की जातीं।
• स्रोत स्थिति/वर्कस्पेस ट्री के अंदर आउटपुट पथों को स्वयं-समावेशन से बचाने के लिए अस्वीकार किया जाता है।
• openclaw backup verify <archive> सत्यापित करता है कि आर्काइव में ठीक एक रूट मैनिफ़ेस्ट है, ट्रैवर्सल-शैली के आर्काइव पथों को अस्वीकार करता है, और जाँचता है कि हर मैनिफ़ेस्ट-घोषित पेलोड टारबॉल में मौजूद है।
• openclaw backup create --verify आर्काइव लिखने के तुरंत बाद वही सत्यापन चलाता है।
• openclaw backup create --only-config केवल सक्रिय JSON कॉन्फ़िग फ़ाइल का बैकअप लेता है।

किन चीज़ों का बैकअप लिया जाता है

openclaw backup create आपकी स्थानीय OpenClaw इंस्टॉल से बैकअप स्रोतों की योजना बनाता है:

• OpenClaw के स्थानीय स्थिति रिज़ॉल्वर द्वारा लौटाई गई स्थिति डायरेक्टरी, आम तौर पर ~/.openclaw
• सक्रिय कॉन्फ़िग फ़ाइल पथ
• हल की गई credentials/ डायरेक्टरी, जब वह स्थिति डायरेक्टरी के बाहर मौजूद हो
• वर्तमान कॉन्फ़िग से खोजी गई वर्कस्पेस डायरेक्टरी, जब तक आप --no-include-workspace पास नहीं करते

मॉडल ऑथ प्रोफ़ाइल पहले से ही स्थिति डायरेक्टरी के अंतर्गत agents/<agentId>/agent/auth-profiles.json में होती हैं, इसलिए वे सामान्यतः स्थिति बैकअप प्रविष्टि द्वारा कवर होती हैं।

यदि आप --only-config का उपयोग करते हैं, तो OpenClaw स्थिति, क्रेडेंशियल-डायरेक्टरी, और वर्कस्पेस खोज को छोड़ देता है और केवल सक्रिय कॉन्फ़िग फ़ाइल पथ को आर्काइव करता है।

OpenClaw आर्काइव बनाने से पहले पथों को कैनॉनिकलाइज़ करता है। यदि कॉन्फ़िग, क्रेडेंशियल डायरेक्टरी, या कोई वर्कस्पेस पहले से ही स्थिति डायरेक्टरी के अंदर है, तो उन्हें अलग शीर्ष-स्तरीय बैकअप स्रोतों के रूप में डुप्लिकेट नहीं किया जाता। गुम पथों को छोड़ दिया जाता है।

आर्काइव पेलोड उन स्रोत ट्री से फ़ाइल सामग्री संग्रहीत करता है, और एम्बेड किया गया manifest.json हर एसेट के लिए उपयोग किए गए आर्काइव लेआउट के साथ हल किए गए पूर्ण स्रोत पथ दर्ज करता है।

आर्काइव बनाते समय, OpenClaw ज्ञात लाइव-म्यूटेशन फ़ाइलों को छोड़ देता है जिनका पुनर्स्थापन में मूल्य नहीं होता, जिनमें सक्रिय एजेंट सेशन ट्रांसक्रिप्ट, cron रन लॉग, रोलिंग लॉग, डिलीवरी क्यू, स्थिति डायरेक्टरी के अंतर्गत socket/pid/temp फ़ाइलें, और संबंधित durable-queue temp फ़ाइलें शामिल हैं। JSON परिणाम में skippedVolatileCount शामिल होता है ताकि ऑटोमेशन देख सके कि कितनी फ़ाइलें जानबूझकर छोड़ी गईं।

स्थिति डायरेक्टरी के extensions/ ट्री के अंतर्गत इंस्टॉल किए गए Plugin स्रोत और मैनिफ़ेस्ट फ़ाइलें शामिल की जाती हैं, लेकिन उनके नेस्टेड node_modules/ निर्भरता ट्री छोड़ दिए जाते हैं। वे निर्भरताएँ पुनर्निर्माण योग्य इंस्टॉल आर्टिफ़ैक्ट हैं; आर्काइव पुनर्स्थापित करने के बाद, यदि पुनर्स्थापित Plugin गुम निर्भरताओं की रिपोर्ट करता है तो openclaw plugins update <id> का उपयोग करें या openclaw plugins install <spec> --force के साथ Plugin को फिर से इंस्टॉल करें।

अमान्य कॉन्फ़िग व्यवहार

openclaw backup जानबूझकर सामान्य कॉन्फ़िग प्रीफ़्लाइट को बायपास करता है ताकि यह रिकवरी के दौरान भी मदद कर सके। क्योंकि वर्कस्पेस खोज वैध कॉन्फ़िग पर निर्भर करती है, openclaw backup create अब तब तेज़ी से विफल होता है जब कॉन्फ़िग फ़ाइल मौजूद हो लेकिन अमान्य हो और वर्कस्पेस बैकअप अभी भी सक्षम हो।

यदि आप उस स्थिति में फिर भी आंशिक बैकअप चाहते हैं, तो फिर से चलाएँ:

openclaw backup create --no-include-workspace

इससे स्थिति, कॉन्फ़िग, और बाहरी क्रेडेंशियल डायरेक्टरी दायरे में रहती हैं जबकि वर्कस्पेस खोज पूरी तरह छोड़ दी जाती है।

यदि आपको केवल कॉन्फ़िग फ़ाइल की ही कॉपी चाहिए, तो कॉन्फ़िग विकृत होने पर भी --only-config काम करता है क्योंकि यह वर्कस्पेस खोज के लिए कॉन्फ़िग पार्स करने पर निर्भर नहीं करता।

आकार और प्रदर्शन

OpenClaw कोई अंतर्निहित अधिकतम बैकअप आकार या प्रति-फ़ाइल आकार सीमा लागू नहीं करता।

व्यावहारिक सीमाएँ स्थानीय मशीन और गंतव्य फ़ाइलसिस्टम से आती हैं:

• अस्थायी आर्काइव लेखन और अंतिम आर्काइव के लिए उपलब्ध स्थान
• बड़े वर्कस्पेस ट्री को वॉक करने और उन्हें .tar.gz में कंप्रेस करने का समय
• यदि आप openclaw backup create --verify का उपयोग करते हैं या openclaw backup verify चलाते हैं, तो आर्काइव को फिर से स्कैन करने का समय
• गंतव्य पथ पर फ़ाइलसिस्टम व्यवहार। OpenClaw बिना-ओवरराइट हार्ड-लिंक पब्लिश चरण को प्राथमिकता देता है और जब हार्ड लिंक समर्थित नहीं होते तो एक्सक्लूसिव कॉपी पर वापस जाता है

बड़े वर्कस्पेस आम तौर पर आर्काइव आकार के मुख्य चालक होते हैं। यदि आप छोटा या तेज़ बैकअप चाहते हैं, तो --no-include-workspace का उपयोग करें।

सबसे छोटे आर्काइव के लिए, --only-config का उपयोग करें।

संबंधित

• CLI संदर्भ