From 3d4f41b9129a2e3f0ea114b6c4d6c2de773e6484 Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Tue, 28 Apr 2026 10:38:17 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@5a1ff1347dfaed1bd26dc86d2309b03cc1cb1ecc

---
 .openclaw-sync/source.json      | 4 ++--
 docs/channels/slack.md          | 2 ++
 docs/gateway/config-channels.md | 6 ++++++
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 0ae28aac0..8b1c1f907 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "d70191f8afd4e67cd12bf3bf8c952c7333e47f13",
-  "syncedAt": "2026-04-28T10:34:33.353Z"
+  "sha": "5a1ff1347dfaed1bd26dc86d2309b03cc1cb1ecc",
+  "syncedAt": "2026-04-28T10:36:38.311Z"
 }
diff --git a/docs/channels/slack.md b/docs/channels/slack.md
index 0eaef6997..9a4abd416 100644
--- a/docs/channels/slack.md
+++ b/docs/channels/slack.md
@@ -632,6 +632,8 @@ Notes:
   <Accordion title="Inbound attachments">
     Slack file attachments are downloaded from Slack-hosted private URLs (token-authenticated request flow) and written to the media store when fetch succeeds and size limits permit. File placeholders include the Slack `fileId` so agents can fetch the original file with `download-file`.
 
+    Downloads use bounded idle and total timeouts. If Slack file retrieval stalls or fails, OpenClaw keeps processing the message and falls back to the file placeholder.
+
     Runtime inbound size cap defaults to `20MB` unless overridden by `channels.slack.mediaMaxMb`.
 
   </Accordion>
diff --git a/docs/gateway/config-channels.md b/docs/gateway/config-channels.md
index 04a1463b0..fa2672d3d 100644
--- a/docs/gateway/config-channels.md
+++ b/docs/gateway/config-channels.md
@@ -390,6 +390,11 @@ WhatsApp runs through the gateway's web channel (Baileys Web). It starts automat
       enabled: true,
       botToken: "xoxb-...",
       appToken: "xapp-...",
+      socketMode: {
+        clientPingTimeout: 15000,
+        serverPingTimeout: 30000,
+        pingPongLoggingEnabled: false,
+      },
       dmPolicy: "pairing",
       allowFrom: ["U123", "U456", "*"],
       dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },
@@ -448,6 +453,7 @@ WhatsApp runs through the gateway's web channel (Baileys Web). It starts automat
 
 - **Socket mode** requires both `botToken` and `appToken` (`SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN` for default account env fallback).
 - **HTTP mode** requires `botToken` plus `signingSecret` (at root or per-account).
+- `socketMode` passes Slack SDK Socket Mode transport tuning through to the public Bolt receiver API. Use it only when investigating ping/pong timeout or stale websocket behavior.
 - `botToken`, `appToken`, `signingSecret`, and `userToken` accept plaintext
   strings or SecretRef objects.
 - Slack account snapshots expose per-credential source/status fields such as