docs(telegram): document group history removal

obviyus · obviyus · commit dad7768da850 · 2026-07-02T09:22:59.000-07:00
diff --git a/docs/channels/ambient-room-events.md b/docs/channels/ambient-room-events.md
@@ -188,7 +188,7 @@ Room events stay strict even when other group requests use automatic replies. Un
 
 Set `historyLimit: 0` to disable group history context.
 
-Supported room-event channels keep recent ambient room messages as context. Discord keeps room-event history until a visible Discord send succeeds, so quiet context is not lost before message-tool delivery.
+Supported room-event channels keep recent ambient room messages as context. Telegram keeps an always-on rolling per-group window bounded by `historyLimit`; user-request turns select entries after the bot's last recorded reply, while room-event turns receive the full recent window so the model can see its own recent posts. The retired Telegram `includeGroupHistoryContext` mode key is removed by `openclaw doctor --fix`.
 
 ## Troubleshooting
 
diff --git a/docs/channels/telegram.md b/docs/channels/telegram.md
@@ -280,22 +280,10 @@ curl "https://api.telegram.org/bot<bot_token>/getUpdates"
 }
 ```
 
-    Group history context defaults to `mention-only`: prior group messages are
-    included only when they were addressed to the bot, are replies to the bot,
-    or are the bot's own messages. Set `includeGroupHistoryContext: "recent"` to
-    include recent room history for trusted groups. Set
-    `includeGroupHistoryContext: "none"` to send no prior Telegram group history
-    with the next turn.
-
-```json5
-{
-  channels: {
-    telegram: {
-      includeGroupHistoryContext: "recent",
-    },
-  },
-}
-```
+    Group history context is always on for groups and bounded by
+    `historyLimit`. Set `channels.telegram.historyLimit: 0` to disable the
+    Telegram group history window. The retired `includeGroupHistoryContext`
+    key is removed by `openclaw doctor --fix`.
 
     Getting the group chat ID:
 
diff --git a/extensions/telegram/AGENTS.md b/extensions/telegram/AGENTS.md
@@ -82,6 +82,13 @@ Verified against Telegram Bot API 10.1, July 1 2026.
   hydration path later.
 - Current local chat context must outrank stale reply ancestry in the prompt.
   Old replied-to messages should not look like the active conversation.
+- The group history window is always on for groups and bounded by
+  `historyLimit`. Do not reintroduce prompt-history gating modes; that
+  regression blinded ambient rooms.
+- The group history window is rolling. Use self-entry watermark selection for
+  "since your last reply" views; do not reintroduce destructive clears because
+  room events are not persisted to the session and cleared context is
+  unrecoverable.
 - Pairing is DM-only. Group and topic authorization need explicit config
   allowlists.
 - Telegram allowlists use numeric sender IDs. Usernames are optional, mutable,
