Mainstream messaging

शांत पूर्वावलोकनों के लिए मैट्रिक्स पुश नियम

जब channels.matrix.streaming "quiet" हो, तो OpenClaw एक ही प्रीव्यू इवेंट को उसी स्थान पर संपादित करता है और अंतिम संपादन को कस्टम कंटेंट फ्लैग से चिह्नित करता है। Matrix क्लाइंट अंतिम संपादन पर केवल तभी सूचना देते हैं जब प्रति-उपयोगकर्ता पुश नियम उस फ्लैग से मेल खाता हो। यह पेज उन ऑपरेटरों के लिए है जो Matrix को स्वयं होस्ट करते हैं और हर प्राप्तकर्ता खाते के लिए वह नियम इंस्टॉल करना चाहते हैं।

यदि आप केवल स्टॉक Matrix सूचना व्यवहार चाहते हैं, तो streaming: "partial" इस्तेमाल करें या स्ट्रीमिंग बंद रहने दें। Matrix चैनल सेटअप देखें।

पूर्वापेक्षाएँ

  • प्राप्तकर्ता उपयोगकर्ता = वह व्यक्ति जिसे सूचना मिलनी चाहिए
  • बॉट उपयोगकर्ता = वह OpenClaw Matrix खाता जो जवाब भेजता है
  • नीचे दिए गए API कॉल के लिए प्राप्तकर्ता उपयोगकर्ता का एक्सेस टोकन इस्तेमाल करें
  • पुश नियम में sender को बॉट उपयोगकर्ता के पूर्ण MXID से मिलाएँ
  • प्राप्तकर्ता खाते में पहले से कार्यरत पुशर होने चाहिए — quiet प्रीव्यू नियम केवल तब काम करते हैं जब सामान्य Matrix पुश डिलीवरी स्वस्थ हो

चरण

  • quiet प्रीव्यू कॉन्फ़िगर करें

    json5
    {channels: {matrix: {  streaming: "quiet",},},}
  • प्राप्तकर्ता का एक्सेस टोकन प्राप्त करें

    जहाँ संभव हो, मौजूदा क्लाइंट सेशन टोकन का दोबारा इस्तेमाल करें। नया टोकन बनाने के लिए:

    bash
    curl -sS -X POST \"https://matrix.example.org/_matrix/client/v3/login" \-H "Content-Type: application/json" \--data '{"type": "m.login.password","identifier": { "type": "m.id.user", "user": "@alice:example.org" },"password": "REDACTED"}'
  • सत्यापित करें कि पुशर मौजूद हैं

    bash
    curl -sS \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \"https://matrix.example.org/_matrix/client/v3/pushers"

    यदि कोई पुशर वापस नहीं आता, तो आगे बढ़ने से पहले इस खाते के लिए सामान्य Matrix पुश डिलीवरी ठीक करें।

  • ओवरराइड पुश नियम इंस्टॉल करें

    OpenClaw अंतिम text-only प्रीव्यू संपादनों को content["com.openclaw.finalized_preview"] = true से चिह्नित करता है। ऐसा नियम इंस्टॉल करें जो उस मार्कर और sender के रूप में बॉट MXID, दोनों से मेल खाए:

    bash
    curl -sS -X PUT \"https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname" \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \-H "Content-Type: application/json" \--data '{"conditions": [  { "kind": "event_match", "key": "type", "pattern": "m.room.message" },  {    "kind": "event_property_is",    "key": "content.m\\.relates_to.rel_type",    "value": "m.replace"  },  {    "kind": "event_property_is",    "key": "content.com\\.openclaw\\.finalized_preview",    "value": true  },  { "kind": "event_match", "key": "sender", "pattern": "@bot:example.org" }],"actions": [  "notify",  { "set_tweak": "sound", "value": "default" },  { "set_tweak": "highlight", "value": false }]}'

    चलाने से पहले बदलें:

    • https://matrix.example.org: आपके होमसर्वर का बेस URL
    • $USER_ACCESS_TOKEN: प्राप्तकर्ता उपयोगकर्ता का एक्सेस टोकन
    • openclaw-finalized-preview-botname: प्रति बॉट प्रति प्राप्तकर्ता अद्वितीय नियम ID (पैटर्न: openclaw-finalized-preview-<botname>)
    • @bot:example.org: आपका OpenClaw बॉट MXID, प्राप्तकर्ता का नहीं
  • सत्यापित करें

    bash
    curl -sS \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \"https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"

    फिर स्ट्रीम किए गए जवाब का परीक्षण करें। quiet मोड में रूम एक quiet ड्राफ्ट प्रीव्यू दिखाता है और ब्लॉक या टर्न पूरा होने पर एक बार सूचना देता है।

  • बाद में नियम हटाने के लिए, प्राप्तकर्ता के टोकन के साथ उसी नियम URL पर DELETE करें।

    मल्टी-बॉट नोट्स

    पुश नियम ruleId से की किए जाते हैं: उसी ID पर PUT दोबारा चलाने से एक ही नियम अपडेट होता है। एक ही प्राप्तकर्ता को सूचना देने वाले कई OpenClaw बॉट के लिए, अलग sender मैच के साथ हर बॉट के लिए एक नियम बनाएँ।

    नए उपयोगकर्ता-परिभाषित override नियम डिफ़ॉल्ट suppress नियमों से पहले डाले जाते हैं, इसलिए कोई अतिरिक्त क्रम पैरामीटर आवश्यक नहीं है। नियम केवल text-only प्रीव्यू संपादनों को प्रभावित करता है जिन्हें उसी स्थान पर अंतिम किया जा सकता है; मीडिया फॉलबैक और stale-preview फॉलबैक सामान्य Matrix डिलीवरी इस्तेमाल करते हैं।

    होमसर्वर नोट्स

    Synapse

    किसी विशेष homeserver.yaml बदलाव की आवश्यकता नहीं है। यदि सामान्य Matrix सूचनाएँ पहले से इस उपयोगकर्ता तक पहुँच रही हैं, तो ऊपर दिया गया प्राप्तकर्ता टोकन + pushrules कॉल मुख्य सेटअप चरण है।

    यदि आप Synapse को रिवर्स प्रॉक्सी या वर्करों के पीछे चलाते हैं, तो सुनिश्चित करें कि /_matrix/client/.../pushrules/ Synapse तक ठीक से पहुँचे। पुश डिलीवरी मुख्य प्रक्रिया या synapse.app.pusher / कॉन्फ़िगर किए गए पुशर वर्करों द्वारा संभाली जाती है — सुनिश्चित करें कि वे स्वस्थ हैं।

    नियम event_property_is पुश-नियम कंडीशन (MSC3758, पुश नियम v1.10) इस्तेमाल करता है, जिसे 2023 में Synapse में जोड़ा गया था। पुराने Synapse रिलीज़ PUT pushrules/... कॉल स्वीकार करते हैं लेकिन चुपचाप कभी कंडीशन से मेल नहीं खाते — यदि अंतिम प्रीव्यू संपादन पर कोई सूचना नहीं आती, तो Synapse अपग्रेड करें।

    Tuwunel

    Synapse जैसा ही फ्लो; अंतिम प्रीव्यू मार्कर के लिए कोई Tuwunel-विशिष्ट कॉन्फ़िग आवश्यक नहीं है।

    यदि उपयोगकर्ता के किसी अन्य डिवाइस पर सक्रिय होने पर सूचनाएँ गायब हो जाती हैं, तो जाँचें कि suppress_push_when_active सक्षम है या नहीं। Tuwunel ने यह विकल्प 1.4.2 (सितंबर 2025) में जोड़ा था और यह एक डिवाइस सक्रिय होने पर दूसरे डिवाइसों पर पुश को जानबूझकर suppress कर सकता है।

    संबंधित

    Was this useful?
    On this page

    On this page