docs(msteams): document replyStyle resolution precedence and thread c… · openclaw/openclaw@79d9b95
harrisali010
·
2026-05-07
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -752,6 +752,27 @@ Teams recently introduced two channel UI styles over the same underlying data mo
|
752 | 752 | } |
753 | 753 | ``` |
754 | 754 | |
| 755 | +### Resolution precedence |
| 756 | + |
| 757 | +When the bot sends a reply into a channel, `replyStyle` is resolved from the most specific override down to the default. The first non-`undefined` value wins: |
| 758 | + |
| 759 | +1. **Per-channel** — `channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle` |
| 760 | +2. **Per-team** — `channels.msteams.teams.<teamId>.replyStyle` |
| 761 | +3. **Global** — `channels.msteams.replyStyle` |
| 762 | +4. **Implicit default** — derived from `requireMention`: |
| 763 | + - `requireMention: true` → `thread` |
| 764 | + - `requireMention: false` → `top-level` |
| 765 | + |
| 766 | +If you set `requireMention: false` globally without an explicit `replyStyle`, mentions in Posts-style channels will surface as top-level posts even when the inbound was a thread reply. Pin `replyStyle: "thread"` at the global, team, or channel level to avoid surprises. |
| 767 | + |
| 768 | +### Thread context preservation |
| 769 | + |
| 770 | +When `replyStyle: "thread"` is in effect and the bot was @mentioned from inside a channel thread, OpenClaw re-attaches the original thread root to the outbound conversation reference (`19:…@thread.tacv2;messageid=<root>`) so the reply lands inside the same thread. This holds for both live (in-turn) sends and proactive sends made after the Bot Framework turn context has expired (e.g., long-running agents, queued tool-call replies via `mcp__openclaw__message`). |
| 771 | + |
| 772 | +The thread root is taken from the stored `threadId` on the conversation reference. Older stored references that predate `threadId` fall back to `activityId` (whatever inbound activity last seeded the conversation), so existing deployments keep working without a re-seed. |
| 773 | + |
| 774 | +When `replyStyle: "top-level"` is in effect, channel-thread inbounds are intentionally answered as new top-level posts — no thread suffix is attached. This is the correct behavior for Threads-style channels; if you see top-level posts where you expected threaded replies, your `replyStyle` is set incorrectly for that channel. |
| 775 | + |
755 | 776 | ## Attachments and images |
756 | 777 | |
757 | 778 | **Current limitations:** |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。