Skip to main content
पिछले सार्वजनिक matrix Plugin से वर्तमान कार्यान्वयन पर अपग्रेड करें। अधिकांश उपयोगकर्ताओं के लिए, अपग्रेड पहले से लागू है:
  • Plugin @openclaw/matrix ही रहता है
  • चैनल matrix ही रहता है
  • आपका कॉन्फ़िगरेशन channels.matrix के अंतर्गत ही रहता है
  • कैश किए गए क्रेडेंशियल साझा state/openclaw.sqlite Plugin स्थिति में चले जाते हैं
  • रनटाइम स्थिति ~/.openclaw/matrix/ के अंतर्गत ही रहती है
आपको कॉन्फ़िगरेशन कुंजियों का नाम बदलने या Plugin को किसी नए नाम से दोबारा इंस्टॉल करने की आवश्यकता नहीं है। रूट openclaw पैकेज अब Matrix रनटाइम कोड या Matrix SDK निर्भरताएँ बंडल नहीं करता। यदि openclaw channels status दिखाता है कि Matrix कॉन्फ़िगर किया गया है, लेकिन Plugin इंस्टॉल नहीं है, तो openclaw doctor --fix या openclaw plugins install @openclaw/matrix चलाएँ; Matrix SDK पैकेजों को रूट OpenClaw पैकेज में इंस्टॉल न करें।

​
माइग्रेशन स्वचालित रूप से क्या करता है

जब आप openclaw doctor --fix चलाते हैं, तब Matrix माइग्रेशन चलता है। समर्पित Matrix स्टोर के पास स्थित फ़ाइल-आधारित साइडकार अपने क्लाइंट-स्टार्ट फ़ॉलबैक को बनाए रखते हैं, लेकिन क्रेडेंशियल-फ़ाइल आयात केवल Doctor में होता है; रनटाइम केवल मानक SQLite क्रेडेंशियल स्थिति पढ़ता है। Doctor माइग्रेशन में ये शामिल हैं:
  • सेवानिवृत्त ~/.openclaw/credentials/matrix/credentials*.json फ़ाइलों को संग्रहित करने से पहले आयात और सत्यापित करना
  • वही खाता चयन और channels.matrix कॉन्फ़िगरेशन बनाए रखना
  • फ़ाइल-आधारित साइडकार स्थिति (bot-storage.json सिंक कैश, recovery-key.json, legacy-crypto-migration.json, IndexedDB स्नैपशॉट) को Matrix SQLite स्थिति में आयात करना; माइग्रेट की गई फ़ाइलें .migrated प्रत्यय के साथ संग्रहित की जाती हैं
  • बाद में एक्सेस टोकन बदलने पर उसी Matrix खाते, होमसर्वर, उपयोगकर्ता और डिवाइस के लिए सबसे पूर्ण मौजूदा टोकन-हैश संग्रहण रूट का पुनः उपयोग करना

​
2026.4 से पुराने OpenClaw रिलीज़ से अपग्रेड करना

2026.6 शृंखला तक के रिलीज़ मूल समतल एकल-स्टोर Matrix लेआउट (~/.openclaw/matrix/bot-storage.json और ~/.openclaw/matrix/crypto/) को भी माइग्रेट करते थे और पुराने rust क्रिप्टो स्टोर से एन्क्रिप्टेड स्थिति की पुनर्प्राप्ति तैयार करते थे। वर्तमान रिलीज़ में वह माइग्रेशन अब शामिल नहीं है। यदि आप ऐसे इंस्टॉलेशन को अपग्रेड कर रहे हैं जो अभी भी समतल लेआउट का उपयोग करता है, तो पहले किसी 2026.6 रिलीज़ पर अपग्रेड करें, openclaw doctor --fix चलाएँ और Gateway को एक बार शुरू करें, ताकि समतल स्टोर और पुनर्प्राप्त किए जा सकने वाले रूम कुंजी माइग्रेट हो जाएँ। फिर नवीनतम रिलीज़ पर अपडेट करें। पिछला सार्वजनिक Matrix Plugin Matrix रूम-कुंजी बैकअप स्वचालित रूप से नहीं बनाता था। यदि आपके पुराने इंस्टॉलेशन में केवल स्थानीय एन्क्रिप्टेड इतिहास था जिसका कभी बैकअप नहीं लिया गया, तो माइग्रेशन पथ चाहे जो हो, अपग्रेड के बाद कुछ पुराने एन्क्रिप्टेड संदेश अपठनीय रह सकते हैं।

​
अनुशंसित अपग्रेड प्रवाह

  1. OpenClaw और Matrix Plugin को सामान्य रूप से अपडेट करें।
  2. चलाएँ:
  3. Gateway शुरू या पुनः शुरू करें।
  4. वर्तमान सत्यापन और बैकअप स्थिति जाँचें:
  5. जिस Matrix खाते की आप मरम्मत कर रहे हैं, उसकी पुनर्प्राप्ति कुंजी को खाते-विशिष्ट पर्यावरण चर में रखें। एकल डिफ़ॉल्ट खाते के लिए MATRIX_RECOVERY_KEY पर्याप्त है। एकाधिक खातों के लिए प्रति खाता एक चर उपयोग करें, उदाहरण के लिए MATRIX_RECOVERY_KEY_ASSISTANT, और कमांड में --account assistant जोड़ें।
  6. यदि OpenClaw बताता है कि पुनर्प्राप्ति कुंजी आवश्यक है, तो संबंधित खाते के लिए कमांड चलाएँ:
  7. यदि यह डिवाइस अभी भी असत्यापित है, तो संबंधित खाते के लिए कमांड चलाएँ:
    यदि पुनर्प्राप्ति कुंजी स्वीकार हो जाती है और बैकअप उपयोग योग्य है, लेकिन Cross-signing verified अभी भी no है, तो किसी अन्य Matrix क्लाइंट से स्व-सत्यापन पूरा करें:
    किसी अन्य Matrix क्लाइंट में अनुरोध स्वीकार करें, इमोजी या दशमलवों की तुलना करें, और केवल उनके मेल खाने पर yes टाइप करें। सफलता की सूचना देने से पहले कमांड पूर्ण Matrix पहचान विश्वसनीयता की प्रतीक्षा करता है।
  8. यदि आप जानबूझकर पुनर्प्राप्त न किए जा सकने वाले पुराने इतिहास को छोड़ रहे हैं और भविष्य के संदेशों के लिए नया बैकअप आधार चाहते हैं, तो चलाएँ:
    केवल तभी --rotate-recovery-key जोड़ें, जब पुरानी पुनर्प्राप्ति कुंजी से नए बैकअप को अनलॉक होना बंद करना हो।
  9. यदि अभी तक कोई सर्वर-पक्षीय कुंजी बैकअप मौजूद नहीं है, तो भविष्य की पुनर्प्राप्तियों के लिए एक बनाएँ:

​
सामान्य संदेश और उनके अर्थ

Failed migrating legacy Matrix client storage: ...
  • अर्थ: Matrix क्लाइंट-पक्षीय फ़ॉलबैक को फ़ाइल-आधारित साइडकार स्थिति मिली, लेकिन SQLite में आयात विफल हो गया। OpenClaw चुपचाप नए स्टोर से शुरू होने के बजाय पूरी की गई स्थानांतरण कार्रवाइयों को वापस करता है और उस फ़ॉलबैक को निरस्त कर देता है।
  • क्या करें: फ़ाइल सिस्टम अनुमतियों या टकरावों की जाँच करें, पुरानी स्थिति को अक्षुण्ण रखें और त्रुटि ठीक करने के बाद पुनः प्रयास करें।
Matrix is installed from a custom path: ...
  • अर्थ: Matrix किसी पथ इंस्टॉलेशन पर पिन है, इसलिए मुख्यधारा के अपडेट इसे डिफ़ॉल्ट Matrix पैकेज से स्वचालित रूप से प्रतिस्थापित नहीं करते।
  • क्या करें: जब आप डिफ़ॉल्ट Matrix Plugin पर वापस जाना चाहें, तो openclaw plugins install @openclaw/matrix से पुनः इंस्टॉल करें।
Matrix is installed from a custom path that no longer exists: ...
  • अर्थ: आपका Plugin इंस्टॉलेशन रिकॉर्ड ऐसे स्थानीय पथ की ओर संकेत करता है जो अब मौजूद नहीं है।
  • क्या करें: openclaw plugins install @openclaw/matrix से पुनः इंस्टॉल करें, या यदि आप रिपॉज़िटरी चेकआउट से चला रहे हैं, तो openclaw plugins install ./path/to/local/matrix-plugin का उपयोग करें। openclaw doctor --fix आपके लिए पुराने Matrix Plugin संदर्भ भी हटा सकता है।

​
मैन्युअल पुनर्प्राप्ति संदेश

जब इस डिवाइस पर रूम-कुंजी बैकअप स्वस्थ नहीं होता, तब openclaw matrix verify status और openclaw matrix verify backup status, Backup issue: पंक्ति के साथ Next steps: मार्गदर्शन दिखाते हैं: अन्य पुनर्प्राप्ति त्रुटियाँ: Matrix recovery key is required
  • अर्थ: आपने आवश्यक होने पर पुनर्प्राप्ति कुंजी दिए बिना पुनर्प्राप्ति चरण का प्रयास किया।
  • क्या करें: --recovery-key-stdin के साथ कमांड दोबारा चलाएँ, उदाहरण के लिए printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdin।
Invalid Matrix recovery key: ...
  • अर्थ: दी गई कुंजी को पार्स नहीं किया जा सका या वह अपेक्षित प्रारूप से मेल नहीं खाती थी।
  • क्या करें: अपने Matrix क्लाइंट या पुनर्प्राप्ति-कुंजी निर्यात से मिली सटीक पुनर्प्राप्ति कुंजी के साथ पुनः प्रयास करें।
Matrix recovery key was applied, but this device still lacks full Matrix identity trust.
  • अर्थ: पुनर्प्राप्ति कुंजी ने उपयोग योग्य बैकअप सामग्री अनलॉक कर दी, लेकिन Matrix ने इस डिवाइस के लिए पूर्ण क्रॉस-साइनिंग पहचान विश्वसनीयता स्थापित नहीं की है। कमांड आउटपुट में Recovery key accepted, Backup usable, Cross-signing verified और Device verified by owner जाँचें।
  • क्या करें: openclaw matrix verify self चलाएँ, किसी अन्य Matrix क्लाइंट में अनुरोध स्वीकार करें, SAS की तुलना करें और केवल मेल खाने पर yes टाइप करें। printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify bootstrap --recovery-key-stdin --force-reset-cross-signing का उपयोग केवल तभी करें, जब आप जानबूझकर वर्तमान क्रॉस-साइनिंग पहचान को प्रतिस्थापित करना चाहते हों।
यदि आप पुनर्प्राप्त न किए जा सकने वाले पुराने एन्क्रिप्टेड इतिहास को खोना स्वीकार करते हैं, तो इसके बजाय openclaw matrix verify backup reset --yes से वर्तमान बैकअप आधार रीसेट कर सकते हैं। जब संग्रहीत बैकअप सीक्रेट खराब होता है, तब यह रीसेट गुप्त संग्रहण को भी ठीक करता है, ताकि नई बैकअप कुंजी पुनः शुरू करने के बाद सही ढंग से लोड हो सके।

​
यदि एन्क्रिप्टेड इतिहास फिर भी वापस नहीं आता

इन जाँचों को क्रम से चलाएँ:
यदि बैकअप सफलतापूर्वक पुनर्स्थापित हो जाता है, लेकिन कुछ पुराने रूम का इतिहास अब भी अनुपलब्ध है, तो संभवतः पिछला Plugin उन अनुपलब्ध कुंजियों का कभी बैकअप नहीं ले पाया था।

​
यदि आप भविष्य के संदेशों के लिए नए सिरे से शुरू करना चाहते हैं

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

​
संबंधित

  • Matrix: चैनल सेटअप और कॉन्फ़िगरेशन।
  • Matrix पुश नियम: सूचना रूटिंग।
  • Doctor: स्वास्थ्य जाँच और स्वचालित माइग्रेशन ट्रिगर।
  • माइग्रेशन मार्गदर्शिका: सभी माइग्रेशन पथ (मशीन स्थानांतरण, क्रॉस-सिस्टम आयात)।
  • Plugins: Plugin इंस्टॉलेशन और पंजीकरण।