Mainstream messaging

Matrix माइग्रेशन

पिछले सार्वजनिक 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 रूम-कुंजी बैकअप स्वचालित रूप से नहीं बनाता था। यदि आपके पुराने इंस्टॉलेशन में केवल स्थानीय एन्क्रिप्टेड इतिहास था जिसका कभी बैकअप नहीं लिया गया, तो माइग्रेशन पथ चाहे जो हो, अपग्रेड के बाद कुछ पुराने एन्क्रिप्टेड संदेश अपठनीय रह सकते हैं।

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

OpenClaw और Matrix Plugin को सामान्य रूप से अपडेट करें।
चलाएँ:
bash
```
openclaw doctor --fix
```
Gateway शुरू या पुनः शुरू करें।
वर्तमान सत्यापन और बैकअप स्थिति जाँचें:
bash
```
openclaw matrix verify statusopenclaw matrix verify backup status
```
जिस Matrix खाते की आप मरम्मत कर रहे हैं, उसकी पुनर्प्राप्ति कुंजी को खाते-विशिष्ट पर्यावरण चर में रखें। एकल डिफ़ॉल्ट खाते के लिए MATRIX_RECOVERY_KEY पर्याप्त है। एकाधिक खातों के लिए प्रति खाता एक चर उपयोग करें, उदाहरण के लिए MATRIX_RECOVERY_KEY_ASSISTANT, और कमांड में --account assistant जोड़ें।
यदि OpenClaw बताता है कि पुनर्प्राप्ति कुंजी आवश्यक है, तो संबंधित खाते के लिए कमांड चलाएँ:
bash
```
printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdinprintf '%s\n' "$MATRIX_RECOVERY_KEY_ASSISTANT" | openclaw matrix verify backup restore --recovery-key-stdin --account assistant
```
यदि यह डिवाइस अभी भी असत्यापित है, तो संबंधित खाते के लिए कमांड चलाएँ:
bash
```
printf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify device --recovery-key-stdinprintf '%s\n' "$MATRIX_RECOVERY_KEY_ASSISTANT" | openclaw matrix verify device --recovery-key-stdin --account assistant
```
यदि पुनर्प्राप्ति कुंजी स्वीकार हो जाती है और बैकअप उपयोग योग्य है, लेकिन Cross-signing verified अभी भी no है, तो किसी अन्य Matrix क्लाइंट से स्व-सत्यापन पूरा करें:
bash
```
openclaw matrix verify self
```
किसी अन्य Matrix क्लाइंट में अनुरोध स्वीकार करें, इमोजी या दशमलवों की तुलना करें, और केवल उनके मेल खाने पर yes टाइप करें। सफलता की सूचना देने से पहले कमांड पूर्ण Matrix पहचान विश्वसनीयता की प्रतीक्षा करता है।
यदि आप जानबूझकर पुनर्प्राप्त न किए जा सकने वाले पुराने इतिहास को छोड़ रहे हैं और भविष्य के संदेशों के लिए नया बैकअप आधार चाहते हैं, तो चलाएँ:
bash
```
openclaw matrix verify backup reset --yes
```
केवल तभी --rotate-recovery-key जोड़ें, जब पुरानी पुनर्प्राप्ति कुंजी से नए बैकअप को अनलॉक होना बंद करना हो।
यदि अभी तक कोई सर्वर-पक्षीय कुंजी बैकअप मौजूद नहीं है, तो भविष्य की पुनर्प्राप्तियों के लिए एक बनाएँ:
bash
```
openclaw matrix verify bootstrap
```

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

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: मार्गदर्शन दिखाते हैं:

बैकअप समस्या	अर्थ	समाधान
`no room-key backup exists on the homeserver`	पुनर्स्थापित करने के लिए कुछ नहीं	रूम कुंजी बैकअप बनाने के लिए `openclaw matrix verify bootstrap`
`backup decryption key is not loaded on this device`	कुंजी मौजूद है, लेकिन यहाँ सक्रिय नहीं है	`openclaw matrix verify backup restore`; यदि यह फिर भी कुंजी लोड नहीं कर पाता, तो पुनर्प्राप्ति कुंजी को `--recovery-key-stdin` के माध्यम से पाइप करें
`backup decryption key could not be loaded from secret storage (...)`	गुप्त संग्रहण लोड विफल हुआ या समर्थित नहीं है	पुनर्प्राप्ति कुंजी पाइप करें: `printf '%s\n' "$MATRIX_RECOVERY_KEY" \| openclaw matrix verify backup restore --recovery-key-stdin`
`backup key mismatch (...)`	संग्रहीत कुंजी सक्रिय सर्वर बैकअप से मेल नहीं खाती	सक्रिय सर्वर बैकअप कुंजी के साथ `verify backup restore --recovery-key-stdin` दोबारा चलाएँ, या नए आधार के लिए `verify backup reset --yes` चलाएँ
`backup signature chain is not trusted by this device`	डिवाइस अभी क्रॉस-साइनिंग शृंखला पर भरोसा नहीं करता	`verify device --recovery-key-stdin`, फिर यदि भरोसा अभी भी अधूरा है तो किसी अन्य सत्यापित क्लाइंट से `verify self`
`backup exists but is not active on this device`	सर्वर बैकअप मौजूद है, स्थानीय सत्र निष्क्रिय है	पहले डिवाइस सत्यापित करें, फिर `openclaw matrix verify backup status` से दोबारा जाँचें
`backup trust state could not be fully determined`	निदान अनिर्णायक था	`openclaw matrix verify status --verbose`

अन्य पुनर्प्राप्ति त्रुटियाँ:

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 से वर्तमान बैकअप आधार रीसेट कर सकते हैं। जब संग्रहीत बैकअप सीक्रेट खराब होता है, तब यह रीसेट गुप्त संग्रहण को भी ठीक करता है, ताकि नई बैकअप कुंजी पुनः शुरू करने के बाद सही ढंग से लोड हो सके।

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

इन जाँचों को क्रम से चलाएँ:

bash

openclaw matrix verify status --verboseopenclaw matrix verify backup status --verboseprintf '%s\n' "$MATRIX_RECOVERY_KEY" | openclaw matrix verify backup restore --recovery-key-stdin --verbose

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

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

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

bash

openclaw matrix verify backup reset --yesopenclaw matrix verify backup status --verboseopenclaw matrix verify status

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