قوانین پوش Matrix برای پیش‌نمایش‌های بی‌صدا

پیکربندی پیش‌نمایش‌های بی‌صدا

{
channels: {
matrix: {
  streaming: "quiet",
},
},
}

دریافت access token گیرنده

تا حد امکان از توکن یک نشست کلاینت موجود دوباره استفاده کنید. برای ساختن یک توکن تازه:

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"
}'

بررسی وجود pusherها

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

اگر هیچ pusherی برنگشت، قبل از ادامه، تحویل push معمول Matrix را برای این حساب درست کنید.

نصب قانون push از نوع override

OpenClaw ویرایش‌های پیش‌نمایش فقط‌متنی نهایی‌شده را با content["com.openclaw.finalized_preview"] = true علامت‌گذاری می‌کند. قانونی نصب کنید که هم با آن نشانگر و هم با MXID ربات به‌عنوان فرستنده مطابقت داشته باشد:

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 پایه homeserver شما
• $USER_ACCESS_TOKEN: access token کاربر گیرنده
• openclaw-finalized-preview-botname: یک شناسه قانون که برای هر ربات و هر گیرنده یکتا است (الگو: openclaw-finalized-preview-<botname>)
• @bot:example.org: MXID ربات OpenClaw شما، نه MXID گیرنده

بررسی

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

سپس یک پاسخ استریم‌شده را آزمایش کنید. در حالت بی‌صدا، اتاق یک پیش‌نمایش پیش‌نویس بی‌صدا نشان می‌دهد و وقتی block یا نوبت تمام شد، یک‌بار اعلان می‌فرستد.