From 61d85b67c77449d78ae0000fb355c50db4daf425 Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Wed, 29 Apr 2026 09:28:41 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@8d58ad4c15cd3723ececd26697b86339a5af2834

---
 .openclaw-sync/source.json | 4 ++--
 docs/gateway/protocol.md   | 6 ++++++
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index 98940ec25..05c96ceff 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "f5e7557c70c18673929c7ddeab6f820157c8b3c9",
-  "syncedAt": "2026-04-29T09:10:03.589Z"
+  "sha": "8d58ad4c15cd3723ececd26697b86339a5af2834",
+  "syncedAt": "2026-04-29T09:27:08.815Z"
 }
diff --git a/docs/gateway/protocol.md b/docs/gateway/protocol.md
index ef12e71d8..17287c592 100644
--- a/docs/gateway/protocol.md
+++ b/docs/gateway/protocol.md
@@ -97,6 +97,12 @@ Gateway → Client:
 }
 ```
 
+While the Gateway is still finishing startup sidecars, the `connect` request can
+return a retryable `UNAVAILABLE` error with `details.reason` set to
+`"startup-sidecars"` and `retryAfterMs`. Clients should retry that response
+within their overall connection budget instead of surfacing it as a terminal
+handshake failure.
+
 `server`, `features`, `snapshot`, and `policy` are all required by the schema
 (`src/gateway/protocol/schema/frames.ts`). `auth` is also required and reports
 the negotiated role/scopes. `canvasHostUrl` is optional.