diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 0a477f28d..d392162ce 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "52257fd05ea9dbc7d362949f1ae79b1da187b6a9",
-  "syncedAt": "2026-05-03T19:13:31.161Z"
+  "sha": "c5488ea5774a4636fc50c47575ce122a317fc52b",
+  "syncedAt": "2026-05-03T19:14:23.055Z"
 }
diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256
index 3f928e642..81a54e3c0 100644
--- a/docs/.generated/config-baseline.sha256
+++ b/docs/.generated/config-baseline.sha256
@@ -1,4 +1,4 @@
-c1de046645b03b1ec47ec41811b67c0e7ad5460842b54416a47757ef22b9b17e  config-baseline.json
+df881d10bfb3d1ba0439e5984117dde70b5f7e856696f25c7f4b5c978a38f841  config-baseline.json
 f945a060012b3e7c675fb3ea0c5f18996cdcc06c9ec6cead389e04791a529ce9  config-baseline.core.json
-76979aba007500abc52b970da76b6512291916739c29d6a3f4218772d1a31186  config-baseline.channel.json
+09a952cf734a5b4a30f760e570c0f106d54aa8e74bf439dd4d07013f9f7607e4  config-baseline.channel.json
 245aa98aabc6c2e3c57a69e639c2fb10d84a7e1e1b3bcdadc340fa61ca998287  config-baseline.plugin.json
diff --git a/docs/channels/telegram.md b/docs/channels/telegram.md
index 551e49e83..c32cb4159 100644
--- a/docs/channels/telegram.md
+++ b/docs/channels/telegram.md
@@ -729,6 +729,7 @@ curl "https://api.telegram.org/bot<bot_token>/getUpdates"
     - `channels.telegram.textChunkLimit` default is 4000.
     - `channels.telegram.chunkMode="newline"` prefers paragraph boundaries (blank lines) before length splitting.
     - `channels.telegram.mediaMaxMb` (default 100) caps inbound and outbound Telegram media size.
+    - `channels.telegram.mediaGroupFlushMs` (default 500) controls how long Telegram albums/media groups are buffered before OpenClaw dispatches them as one inbound message. Increase it if album parts arrive late; decrease it to reduce album reply latency.
     - `channels.telegram.timeoutSeconds` overrides Telegram API client timeout (if unset, grammY default applies). Bot clients clamp configured values below the 60-second outbound text/typing request guard so grammY does not abort visible reply delivery before OpenClaw's transport guard and fallback can run. Long polling still uses a 45-second `getUpdates` request guard so idle polls are not abandoned indefinitely.
     - `channels.telegram.pollingStallThresholdMs` defaults to `120000`; tune between `30000` and `600000` only for false-positive polling-stall restarts.
     - group context history uses `channels.telegram.historyLimit` or `messages.groupChat.historyLimit` (default 50); `0` disables.
@@ -950,7 +951,7 @@ Primary reference: [Configuration reference - Telegram](/gateway/config-channels
 - threading/replies: `replyToMode`, `dm.threadReplies`, `direct.*.threadReplies`
 - streaming: `streaming` (preview), `streaming.preview.toolProgress`, `blockStreaming`
 - formatting/delivery: `textChunkLimit`, `chunkMode`, `linkPreview`, `responsePrefix`
-- media/network: `mediaMaxMb`, `timeoutSeconds`, `pollingStallThresholdMs`, `retry`, `network.autoSelectFamily`, `network.dangerouslyAllowPrivateNetwork`, `proxy`
+- media/network: `mediaMaxMb`, `mediaGroupFlushMs`, `timeoutSeconds`, `pollingStallThresholdMs`, `retry`, `network.autoSelectFamily`, `network.dangerouslyAllowPrivateNetwork`, `proxy`
 - custom API root: `apiRoot` (Bot API root only; do not include `/bot<TOKEN>`)
 - webhook: `webhookUrl`, `webhookSecret`, `webhookPath`, `webhookHost`
 - actions/capabilities: `capabilities.inlineButtons`, `actions.sendMessage|editMessage|deleteMessage|reactions|sticker`