diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 76f56e940..4d845f486 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "a9d77b3eb09d5e59d551921632775b70dec2c0ba",
-  "syncedAt": "2026-05-04T05:50:54.867Z"
+  "sha": "a224810a7f96e4688aa0bac397a58ce7d3b7322e",
+  "syncedAt": "2026-05-04T05:53:13.763Z"
 }
diff --git a/docs/cli/sessions.md b/docs/cli/sessions.md
index 62dfb1461..9dfdefa19 100644
--- a/docs/cli/sessions.md
+++ b/docs/cli/sessions.md
@@ -16,6 +16,12 @@ until a message is processed. Use `openclaw channels status --probe`,
 `openclaw status --deep`, or `openclaw health --verbose` when you need live
 channel connectivity.
 
+Gateway `sessions.list` responses are bounded by default so large long-lived
+stores cannot monopolize the Gateway event loop. Pass an explicit positive
+`limit` from RPC clients when a different result window is needed; responses
+include `totalCount`, `limitApplied`, and `hasMore` when callers need to show
+that more rows exist.
+
 ```bash
 openclaw sessions
 openclaw sessions --agent work