docs(telegram, streaming): note replyToMode and toolProgress mutual e… · openclaw/openclaw@b336efd
GodsBoy
·
2026-05-03
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -301,6 +301,10 @@ curl "https://api.telegram.org/bot<bot_token>/getUpdates"
|
301 | 301 | |
302 | 302 | Use `streaming.mode: "off"` only when you want final-only delivery: Telegram preview edits are disabled and generic tool/progress chatter is suppressed instead of being sent as standalone "Working..." messages. Approval prompts, media payloads, and errors still route through normal final delivery. Use `streaming.preview.toolProgress: false` when you only want to keep answer preview edits while hiding the tool-progress status lines. |
303 | 303 | |
| 304 | +<Note> |
| 305 | + `streaming.preview.toolProgress` requires `channels.telegram.replyToMode: "off"`. When quote-reply is enabled (`replyToMode: "first"`, `"all"`, or `"batched"`), Telegram requires the final message reference at send time, which is incompatible with preview-edit streaming. The two features are mutually exclusive: tool-progress lines cannot appear in the same preview message that will later be replaced by a quoted final reply. To restore tool-progress visibility, set `replyToMode: "off"`. To suppress the warning while keeping quote-reply, set `streaming.preview.toolProgress: false` to acknowledge the trade-off. |
| 306 | +</Note> |
| 307 | + |
304 | 308 | For text-only replies: |
305 | 309 | |
306 | 310 | - short DM/group/topic previews: OpenClaw keeps the same preview message and performs a final edit in place |
|
| Original file line number | Diff line number | Diff line change |
|---|
@@ -194,6 +194,7 @@ Supported surfaces:
|
194 | 194 | - **Mattermost** already folds tool activity into its single draft preview post (see above). |
195 | 195 | - 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. On Telegram, `streaming.mode: "off"` is final-only: generic progress chatter is also suppressed instead of being delivered as standalone "Working..." messages, while approval prompts, media payloads, and errors still route normally. |
196 | 196 | - To keep preview streaming but hide tool-progress lines, set `streaming.preview.toolProgress` to `false` for that channel. To disable preview edits entirely, set `streaming.mode` to `off`. |
| 197 | +- On Telegram specifically, `streaming.preview.toolProgress` requires `channels.telegram.replyToMode: "off"`. Quote-reply needs the final message reference at send time, which is incompatible with preview-edit streaming, so the two are mutually exclusive. See [Telegram channel docs](/channels/telegram) for the full note. |
197 | 198 | |
198 | 199 | Example: |
199 | 200 | |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。
