docs(gateway): troubleshoot group @mention silent suppression (#77052) · openclaw/openclaw@324a95d
yetval
·
2026-05-19
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -799,7 +799,13 @@ for every group/channel request.
|
799 | 799 | |
800 | 800 | If the message tool is unavailable under the active tool policy, OpenClaw falls back to automatic visible replies instead of silently suppressing the response. `openclaw doctor` warns about this mismatch. |
801 | 801 | |
802 | | -The gateway hot-reloads `messages` config after the file is saved. Restart only when file watching or config reload is disabled in the deployment. |
| 802 | +**Troubleshooting: group @mention triggers typing then silence (no error)** |
| 803 | + |
| 804 | +Symptom: a group/channel @mention shows the typing indicator and the gateway log reports `dispatch complete (queuedFinal=false, replies=0)`, but no message lands in the room. DMs to the same agent reply normally. |
| 805 | + |
| 806 | +Cause: the group/channel visible-reply mode resolves to `"message_tool"`, so OpenClaw runs the turn but suppresses the final assistant text unless the agent calls `message(action=send)`. There is no error because suppression is the configured behavior. Normal group and channel turns default to `"automatic"`, so this symptom only appears when `messages.groupChat.visibleReplies` (or global `messages.visibleReplies`) is explicitly set to `"message_tool"`. Harness `defaultVisibleReplies` does not apply here — the group/channel resolver ignores it; it only affects direct/source chats (the Codex harness suppresses direct-chat finals that way). |
| 807 | + |
| 808 | +Fix: either pick a stronger tool-calling model, remove the explicit `"message_tool"` override to fall back to the `"automatic"` default, or set `messages.groupChat.visibleReplies: "automatic"` to force visible replies for every group/channel request. The gateway hot-reloads `messages` config after the file is saved; only restart the gateway when file watching or config reload is disabled in the deployment. |
803 | 809 | |
804 | 810 | **Mention types:** |
805 | 811 | |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。