Channels 导读

Matrix push rules for quiet previews：消息从哪扇门跑进来

Matrix push rules for quiet previews 像一扇接消息的门。你要看清门铃装在哪、钥匙交给谁、什么人能进来，以及门口最容易被绊一跤的是哪块砖。原文最响的一记鼓点，其实是：When 消息通道s.matrix.一边说一边送ing is "quiet", OpenClaw edits a single preview event in place…。

先听这页的人话版

Matrix push rules for quiet previews

这一页不是在堆术语，它像把“Matrix push rules for quiet previews”这台小机器搬到桌上，当着你的面拆开给你看。你先不用全记住，先抓住它到底在忙什么：When 消息通道s.matrix.一边说一边送ing is "quiet", OpenClaw edits a single preview event in place and mark…。

如果把这页当成“给普通人看的版本”，你最应该带走的是：它到底在教你一件什么事、什么时候要这样做、以及哪里最容易踩坑。

原始路径：/channels/matrix-push-rules 章节数量：6 查看原文

第 1 站

Start Here

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

这段在解决什么

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

为什么值得看

很多文档看起来长，其实是在防你漏掉前置条件。

真要动手时

真正照做时，先找前置条件，再找必填项，最后看验证方法。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：When 消息通道s.matrix.一边说一边送ing is "quiet", OpenClaw edits a single preview event in place and marks the finalized edit wit…。

像讲绘本

原文小纸条

When channels.matrix.streaming is "quiet", OpenClaw edits a single preview event in place and marks the finalized edit with a custom content flag. Matrix clients notify on the final edit only if a per-user push rule matches that flag. This page is for operators who self-host Matrix and want to install that rule for each recipient account.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If you only want stock Matrix notification behavior, use 一边说一边送ing: "partial" or leave 一边说一边送ing off. See Matrix 消息通道 s…。

原文小纸条

If you only want stock Matrix notification behavior, use streaming: "partial" or leave streaming off. See Matrix channel setup.

第 2 站

Prerequisites

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这段在解决什么

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

为什么值得看

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

真要动手时

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

先别急着背术语

这一小段像旁白，在提醒我们镜头已经切到下一站。

像准备清单

这一串条目别硬背，把它当成“Prerequisites”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：recipient user = the person who should re…、bot user = the OpenClaw Matrix account th…、use the recipient user's access token for…、match sender in the push rule against the…。

原文小纸条

recipient user = the person who should receive the notification
bot user = the OpenClaw Matrix account that sends the reply
use the recipient user's access token for the API calls below
match sender in the push rule against the bot user's full MXID
the recipient account must already have working pushers — quiet preview rules only work when normal Matrix push delivery is healthy

第 3 站

Steps

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

这段在解决什么

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

为什么值得看

很多文档看起来长，其实是在防你漏掉前置条件。

真要动手时

真正照做时，先找前置条件，再找必填项，最后看验证方法。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Steps 设置说明书ure quiet previews Get the recipient's access token Reuse an existing 来帮忙的小伙伴 session token where possible.…。

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Steps。

原文小纸条

Steps

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：设置说明书ure quiet previews。

原文小纸条

Configure quiet previews

像魔法口令拆解

这段不是对白，而是一叠设置卡片，像在给系统贴门牌、路线和规矩。

大括号像两只手把同一组设置拢住，意思是“这些东西算一伙”。
这里在给“channels”挂牌子，告诉系统它该指向“{”。
这里在给“matrix”挂牌子，告诉系统它该指向“{”。

原文代码块

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

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Get the recipient's access token。

原文小纸条

Get the recipient's access token

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Reuse an existing 来帮忙的小伙伴 session token where possible. To mint a fresh one:。

原文小纸条

Reuse an existing client session token where possible. To mint a fresh one:

像魔法口令拆解

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

这一句像在终端上按下启动钮：“curl -sS -X POST \”。它会让电脑去请求、安装或者把东西搭起来。
这里在给“https”挂牌子，告诉系统它该指向“//matrix.example.org/_matrix/client/v3/login \”。
这里在给“-H Content-Type”挂牌子，告诉系统它该指向“application/json \”。

原文代码块

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

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Verify pushers exist。

原文小纸条

Verify pushers exist

像魔法口令拆解

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

这一句像在终端上按下启动钮：“curl -sS \”。它会让电脑去请求、安装或者把东西搭起来。
这里在给“-H Authorization”挂牌子，告诉系统它该指向“Bearer $USER_ACCESS_TOKEN \”。
这里在给“https”挂牌子，告诉系统它该指向“//matrix.example.org/_matrix/client/v3/pushers”。

原文代码块

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

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If no pushers come back, fix normal Matrix push delivery for this account before continuing.

原文小纸条

If no pushers come back, fix normal Matrix push delivery for this account before continuing.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Install the override push rule。

原文小纸条

Install the override push rule

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：OpenClaw marks finalized text-only preview edits with content["com.openclaw.finalized_preview"] = true. Install a rule…。

原文小纸条

OpenClaw marks finalized text-only preview edits with content["com.openclaw.finalized_preview"] = true. Install a rule that matches that marker plus the bot MXID as sender:

像魔法口令拆解

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

这一句像在终端上按下启动钮：“curl -sS -X PUT \”。它会让电脑去请求、安装或者把东西搭起来。
这里在给“https”挂牌子，告诉系统它该指向“//matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname \”。
这里在给“-H Authorization”挂牌子，告诉系统它该指向“Bearer $USER_ACCESS_TOKEN \”。

原文代码块

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

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Replace before running:。

原文小纸条

Replace before running:

像准备清单

这一串条目别硬背，把它当成“Steps”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：https://matrix.example.org: your home大房子服…、$USER_ACCESS_TOKEN: the recipient user's…、openclaw-finalized-preview-botname: a rul…、@bot:example.org: your OpenClaw bot MXID,…。

原文小纸条

https://matrix.example.org: your homeserver base URL
$USER_ACCESS_TOKEN: the recipient user's access token
openclaw-finalized-preview-botname: a rule ID unique per bot per recipient (pattern: openclaw-finalized-preview-<botname>)
@bot:example.org: your OpenClaw bot MXID, not the recipient's

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Verify。

原文小纸条

Verify

像魔法口令拆解

这是一串终端口令，像你站在控制台前，一下下按按钮让机器醒过来。

这一句像在终端上按下启动钮：“curl -sS \”。它会让电脑去请求、安装或者把东西搭起来。
这里在给“-H Authorization”挂牌子，告诉系统它该指向“Bearer $USER_ACCESS_TOKEN \”。
这里在给“https”挂牌子，告诉系统它该指向“//matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname”。

原文代码块

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

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Then test a 一边说一边送ed reply. In quiet mode the room shows a quiet draft preview and notifies once the block or turn fini…。

原文小纸条

Then test a streamed reply. In quiet mode the room shows a quiet draft preview and notifies once the block or turn finishes.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：To remove the rule later, DELETE the same rule URL with the recipient's token.

原文小纸条

To remove the rule later, DELETE the same rule URL with the recipient's token.

第 4 站

Multi-bot notes

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这段在解决什么

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

为什么值得看

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

真要动手时

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Push rules are keyed by ruleId: re-running PUT against the same ID updates a single rule. For multiple OpenClaw bots no…。

像讲绘本

原文小纸条

Push rules are keyed by ruleId: re-running PUT against the same ID updates a single rule. For multiple OpenClaw bots notifying the same recipient, create one rule per bot with a distinct sender match.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：New user-defined override rules are inserted ahead of default suppress rules, so no extra ordering parameter is needed.…。

原文小纸条

New user-defined override rules are inserted ahead of default suppress rules, so no extra ordering parameter is needed. The rule only affects text-only preview edits that can be finalized in place; media fallbacks and stale-preview fallbacks use normal Matrix delivery.

第 5 站

Home大房子服务器 notes

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这段在解决什么

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

为什么值得看

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

真要动手时

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Accordion大家一起的房间 Synapse No special home大房子服务器.yaml change is required. If normal Matrix notifications already reach th…。

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Accordion大家一起的房间。

原文小纸条

AccordionGroup

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Synapse。

原文小纸条

Synapse

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：No special home大房子服务器.yaml change is required. If normal Matrix notifications already reach this user, the recipient to…。

原文小纸条

No special homeserver.yaml change is required. If normal Matrix notifications already reach this user, the recipient token + pushrules call above is the main setup step.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If you run Synapse behind a reverse proxy or workers, make sure /_matrix/来帮忙的小伙伴/.../pushrules/ reaches Synapse correct…。

原文小纸条

If you run Synapse behind a reverse proxy or workers, make sure /_matrix/client/.../pushrules/ reaches Synapse correctly. Push delivery is handled by the main process or synapse.app.pusher / configured pusher workers — ensure those are healthy.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The rule uses the event_property_is push-rule condition (MSC3758, push rule v1.10), which was added to Synapse in 2023.…。

原文小纸条

The rule uses the event_property_is push-rule condition (MSC3758, push rule v1.10), which was added to Synapse in 2023. Older Synapse releases accept the PUT pushrules/... call but silently never match the condition — upgrade Synapse if no notification arrives on a finalized preview edit.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Tuwunel。

原文小纸条

Tuwunel

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Same flow as Synapse; no Tuwunel-specific 设置说明书 is needed for the finalized preview marker.

原文小纸条

Same flow as Synapse; no Tuwunel-specific config is needed for the finalized preview marker.

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If notifications disappear while the user is active on another device, check whether suppress_push_when_active is enabl…。

原文小纸条

If notifications disappear while the user is active on another device, check whether suppress_push_when_active is enabled. Tuwunel added this option in 1.4.2 (September 2025) and it can intentionally suppress pushes to other devices while one device is active.

第 6 站

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

这段在解决什么

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

为什么值得看

很多文档看起来长，其实是在防你漏掉前置条件。

真要动手时

真正照做时，先找前置条件，再找必填项，最后看验证方法。

先别急着背术语

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：---。

像准备清单

这一串条目别硬背，把它当成“Related”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：Matrix 消息通道 setup、一边说一边送ing concepts。

原文小纸条

像讲绘本

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：---。

原文小纸条

---

AdSense 连接验证已经放在页面头部；广告单元等站点审批通过后再启用。

google-adsense-account: ca-pub-3833673520933536