From dd2b8764d8d2d5fc5bd53af090722322ba9c03ff Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Mon, 6 Apr 2026 01:15:40 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@e02ef0710e5f049c87950f39951c19823e283cfc

---
 .openclaw-sync/source.json |  4 ++--
 docs/channels/matrix.md    | 19 +++++++++++++++++--
 2 files changed, 19 insertions(+), 4 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 0cb72bab1..bee147c1d 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "177ee54f05d69255eedeba4bca8508fa4113e2e0",
-  "syncedAt": "2026-04-06T01:03:50.238Z"
+  "sha": "e02ef0710e5f049c87950f39951c19823e283cfc",
+  "syncedAt": "2026-04-06T01:15:39.907Z"
 }
diff --git a/docs/channels/matrix.md b/docs/channels/matrix.md
index 96a5aeba5..8a0c2d33c 100644
--- a/docs/channels/matrix.md
+++ b/docs/channels/matrix.md
@@ -281,7 +281,7 @@ OpenClaw marks finalized text-only preview edits with:
 
 ```bash
 curl -sS -X PUT \
-  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview" \
+  "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 '{
@@ -311,8 +311,15 @@ Replace these values before you run the command:
 
 - `https://matrix.example.org`: your homeserver base URL
 - `$USER_ACCESS_TOKEN`: the receiving user's access token
+- `openclaw-finalized-preview-botname`: a rule ID unique to this bot for this receiving user
 - `@bot:example.org`: your OpenClaw Matrix bot MXID, not the receiving user's MXID
 
+Important for multi-bot setups:
+
+- Push rules are keyed by `ruleId`. Re-running `PUT` against the same rule ID updates that one rule.
+- If one receiving user should notify for multiple OpenClaw Matrix bot accounts, create one rule per bot with a unique rule ID for each sender match.
+- A simple pattern is `openclaw-finalized-preview-<botname>`, such as `openclaw-finalized-preview-ops` or `openclaw-finalized-preview-support`.
+
 The rule is evaluated against the event sender:
 
 - authenticate with the receiving user's token
@@ -323,12 +330,20 @@ The rule is evaluated against the event sender:
 ```bash
 curl -sS \
   -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
-  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview"
+  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"
 ```
 
 7. Test a streamed reply. In quiet mode, the room should show a quiet draft preview and the final
    in-place edit should notify once the block or turn finishes.
 
+If you need to remove the rule later, delete that same rule ID with the receiving user's token:
+
+```bash
+curl -sS -X DELETE \
+  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
+  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"
+```
+
 Notes:
 
 - Create the rule with the receiving user's access token, not the bot's.