From 28ac0cb55b6a76e7c956ef894281676b7cbb8b73 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Fri, 1 May 2026 02:55:25 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@8989ceee50abd77c33352e36468b341f40591a5e --- .openclaw-sync/source.json | 4 ++-- docs/channels/groups.md | 4 ++++ docs/gateway/config-channels.md | 2 ++ 3 files changed, 8 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 9d3c0fac5..96eb7ba30 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "ce833acbdba4681ac3c4b12391703492eeee17aa", - "syncedAt": "2026-05-01T02:51:50.855Z" + "sha": "8989ceee50abd77c33352e36468b341f40591a5e", + "syncedAt": "2026-05-01T02:53:33.752Z" } diff --git a/docs/channels/groups.md b/docs/channels/groups.md index 47cb60c0a..37a234aa2 100644 --- a/docs/channels/groups.md +++ b/docs/channels/groups.md @@ -43,6 +43,10 @@ otherwise -> reply For group/channel rooms, OpenClaw defaults to `messages.groupChat.visibleReplies: "message_tool"`. That means the agent still processes the turn and can update memory/session state, but its normal final answer is not automatically posted back into the room. To speak visibly, the agent uses `message(action=send)`. +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. + For direct chats and any other source turn, use `messages.visibleReplies: "message_tool"` to apply the same tool-only visible-reply behavior globally. `messages.groupChat.visibleReplies` remains the more specific override for group/channel rooms. This replaces the old pattern of forcing the model to answer `NO_REPLY` for most lurk-mode turns. In tool-only mode, doing nothing visible simply means not calling the message tool. diff --git a/docs/gateway/config-channels.md b/docs/gateway/config-channels.md index a34deb177..09248e4ce 100644 --- a/docs/gateway/config-channels.md +++ b/docs/gateway/config-channels.md @@ -772,6 +772,8 @@ Group messages default to **require mention** (metadata mention or safe regex pa Visible replies are controlled separately. Group/channel rooms default to `messages.groupChat.visibleReplies: "message_tool"`: OpenClaw still processes the turn, but normal final replies stay private and visible room output requires `message(action=send)`. Set `"automatic"` only when you want the legacy behavior where normal replies are posted back to the room. To apply the same tool-only visible-reply behavior to direct chats too, set `messages.visibleReplies: "message_tool"`. +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. + The gateway hot-reloads `messages` config after the file is saved. Restart only when file watching or config reload is disabled in the deployment. **Mention types:**