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

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

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

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

پیش‌نیازها

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

مراحل

{channels: {matrix: {  streaming: { mode: "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"

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

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

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

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

نکات homeserver

مرتبط

• راه‌اندازی کانال Matrix
• مفاهیم پخش جریانی