قواعد پوش ماتریس برای پیش‌نمایش‌های بی‌صدا

وقتی channels.matrix.streaming روی "quiet" تنظیم شده باشد، OpenClaw پاسخ را با ویرایش درجا و پیوستهٔ یک رویداد پیش‌نمایش واحد ارسال می‌کند. پیش‌نمایش‌ها به‌صورت رویدادهای بدون اعلان m.notice ارسال می‌شوند و ویرایش نهایی با content["com.openclaw.finalized_preview"] = true علامت‌گذاری می‌شود. کلاینت‌های Matrix تنها در صورتی برای آن ویرایش نهایی اعلان می‌فرستند که یک قانون ارسال اعلان مختص کاربر با این نشانگر مطابقت داشته باشد. این صفحه برای اپراتورهایی است که Matrix را به‌صورت خودمیزبان اجرا می‌کنند و می‌خواهند این قانون را برای حساب هر گیرنده نصب کنند.

streaming: "progress" پیش‌نویس‌های خود را از همان مسیر نهایی می‌کند، بنابراین همین قانون برای ویرایش‌های نهایی‌شده در حالت پیشرفت نیز فعال می‌شود.

اگر فقط رفتار استاندارد اعلان‌های Matrix را می‌خواهید، از streaming: "partial" استفاده کنید یا ارسال پیوسته را غیرفعال بگذارید. به راه‌اندازی کانال Matrix مراجعه کنید.

پیش‌نیازها

• کاربر گیرنده = شخصی که باید اعلان را دریافت کند
• کاربر ربات = حساب Matrix متعلق به OpenClaw که پاسخ را ارسال می‌کند
• برای فراخوانی‌های API زیر از توکن دسترسی کاربر گیرنده استفاده کنید
• مقدار sender در قانون ارسال اعلان را با MXID کامل کاربر ربات مطابقت دهید
• حساب گیرنده باید از قبل ارسال‌کننده‌های اعلان فعال داشته باشد؛ قوانین پیش‌نمایش بی‌صدا فقط زمانی کار می‌کنند که تحویل عادی اعلان‌های Matrix سالم باشد

مراحل

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

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

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

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

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

برای حذف قانون در آینده، با توکن گیرنده درخواست DELETE را به همان نشانی قانون ارسال کنید.

نکات مربوط به چند ربات

قوانین ارسال اعلان با ruleId کلیدگذاری می‌شوند: اجرای دوبارهٔ PUT برای همان شناسه، یک قانون واحد را به‌روزرسانی می‌کند. برای چند ربات OpenClaw که به یک گیرنده اعلان می‌فرستند، برای هر ربات یک قانون با تطبیق فرستندهٔ مجزا ایجاد کنید.

قوانین جدید override تعریف‌شده توسط کاربر پیش از قوانین پیش‌فرض سرور برای سرکوب اعلان درج می‌شوند، بنابراین به پارامتر ترتیب‌دهی اضافی نیازی نیست. این قانون فقط بر ویرایش‌های پیش‌نمایش صرفاً متنی اثر می‌گذارد که بتوان آن‌ها را درجا نهایی کرد؛ پاسخ‌های رسانه‌ای، بازگشت‌های جایگزین ناشی از پیش‌نمایش منقضی و متن‌های نهایی‌ای که اشاره‌های Matrix را فعال می‌کنند، در عوض به‌صورت پیام‌های عادی همراه با اعلان تحویل داده می‌شوند.

نکات سرور خانگی

مرتبط

• راه‌اندازی کانال Matrix
• مفاهیم ارسال پیوسته