From 8b706e33a3d6032105cda26eaf0b314611f32d47 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Mon, 27 Apr 2026 20:26:48 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@b9fd13e8d7304fd5d35f93bee1dd460484fcc94d --- .openclaw-sync/source.json | 4 ++-- docs/.generated/config-baseline.sha256 | 6 +++--- docs/channels/matrix.md | 21 ++++++++++++++++++++- docs/concepts/qa-matrix.md | 1 + docs/concepts/streaming.md | 2 +- 5 files changed, 27 insertions(+), 7 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index c2e13917a..72d42a1fb 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "465b621cf1ab06805f364435305ce548efc6dfa8", - "syncedAt": "2026-04-27T20:12:30.334Z" + "sha": "b9fd13e8d7304fd5d35f93bee1dd460484fcc94d", + "syncedAt": "2026-04-27T20:25:13.492Z" } diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256 index 870e89329..e366e50b1 100644 --- a/docs/.generated/config-baseline.sha256 +++ b/docs/.generated/config-baseline.sha256 @@ -1,4 +1,4 @@ -51586a795b6e1b821b3ccb2ef8e92e69ba4ef65fea254738b5a0b7b380d91bd1 config-baseline.json +5e437b340f321aafa12697df2b77a2f13b33069042784fd49de4273ebacf46be config-baseline.json 7dcb21e47ddd5de98e2af1ecbc41e11ac0c5742819c359e6d851fbc39c0226e9 config-baseline.core.json -07963db49502132f26db396c56b36e018b110e6c55a68b3cb012d3ec96f43901 config-baseline.channel.json -13d038300d90d4dd064aa2ac79def867799d1be403cf9d3e81dfad35ef459a21 config-baseline.plugin.json +c4f07c228d4f07e7afafa5b600b4a80f5b26aaed7267c7287a64d04a527be8e8 config-baseline.channel.json +10400fb5b294fe3f2e97ab69327c75308bb2bf014b399ec0e2d59b8cd9d16ff1 config-baseline.plugin.json diff --git a/docs/channels/matrix.md b/docs/channels/matrix.md index 908fdbc50..59c5f9dfd 100644 --- a/docs/channels/matrix.md +++ b/docs/channels/matrix.md @@ -189,6 +189,24 @@ Matrix reply streaming is opt-in. `streaming` controls how OpenClaw delivers the } ``` +To keep live answer previews but hide interim tool/progress lines, use object +form: + +```json5 +{ + channels: { + matrix: { + streaming: { + mode: "partial", + preview: { + toolProgress: false, + }, + }, + }, + }, +} +``` + | `streaming` | Behavior | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `"off"` (default) | Wait for the full reply, send once. `true` ↔ `"partial"`, `false` ↔ `"off"`. | @@ -206,6 +224,7 @@ Notes: - If a preview grows past Matrix's per-event size limit, OpenClaw stops preview streaming and falls back to final-only delivery. - Media replies always send attachments normally. If a stale preview can no longer be reused safely, OpenClaw redacts it before sending the final media reply. +- Tool-progress preview updates are enabled by default when Matrix preview streaming is active. Set `streaming.preview.toolProgress: false` to keep preview edits for answer text but leave tool progress on the normal delivery path. - Preview edits cost extra Matrix API calls. Leave `streaming: "off"` if you want the most conservative rate-limit profile. ## Approval metadata @@ -850,7 +869,7 @@ Allowlist-style fields (`groupAllowFrom`, `dm.allowFrom`, `groups..users`) - `replyToMode`: `"off"`, `"first"`, `"all"`, or `"batched"`. - `threadReplies`: `"off"`, `"inbound"`, or `"always"`. - `threadBindings`: per-channel overrides for thread-bound session routing and lifecycle. -- `streaming`: `"off"` (default), `"partial"`, `"quiet"`. `true` ↔ `"partial"`, `false` ↔ `"off"`. +- `streaming`: `"off"` (default), `"partial"`, `"quiet"`, or object form `{ mode, preview: { toolProgress } }`. `true` ↔ `"partial"`, `false` ↔ `"off"`. - `blockStreaming`: when `true`, completed assistant blocks are kept as separate progress messages. - `markdown`: optional Markdown rendering config for outbound text. - `responsePrefix`: optional string prepended to outbound replies. diff --git a/docs/concepts/qa-matrix.md b/docs/concepts/qa-matrix.md index 2f9317875..b2899fa10 100644 --- a/docs/concepts/qa-matrix.md +++ b/docs/concepts/qa-matrix.md @@ -82,6 +82,7 @@ The full scenario id list is the `MatrixQaScenarioId` union in `extensions/qa-ma - threading — `matrix-thread-*`, `matrix-subagent-thread-spawn` - top-level / DM / room — `matrix-top-level-reply-shape`, `matrix-room-*`, `matrix-dm-*` +- streaming and tool progress — `matrix-room-partial-streaming-preview`, `matrix-room-quiet-streaming-preview`, `matrix-room-tool-progress-*`, `matrix-room-block-streaming` - media — `matrix-media-type-coverage`, `matrix-room-image-understanding-attachment`, `matrix-attachment-only-ignored`, `matrix-unsupported-media-safe` - routing — `matrix-room-autojoin-invite`, `matrix-secondary-room-*` - reactions — `matrix-reaction-*` diff --git a/docs/concepts/streaming.md b/docs/concepts/streaming.md index f7db2cc0d..ec55e80b1 100644 --- a/docs/concepts/streaming.md +++ b/docs/concepts/streaming.md @@ -188,7 +188,7 @@ Preview streaming can also include **tool-progress** updates — short status li Supported surfaces: -- **Discord**, **Slack**, and **Telegram** stream tool-progress into the live preview edit by default when preview streaming is active. +- **Discord**, **Slack**, **Telegram**, and **Matrix** stream tool-progress into the live preview edit by default when preview streaming is active. - Telegram has shipped with tool-progress preview updates enabled since `v2026.4.22`; keeping them enabled preserves that released behavior. - **Mattermost** already folds tool activity into its single draft preview post (see above). - Tool-progress edits follow the active preview streaming mode; they are skipped when preview streaming is `off` or when block streaming has taken over the message.