From ceac0d6703e2adaec5e13647056f3961c60a92ed Mon Sep 17 00:00:00 2001
From: "openclaw-docs-sync[bot]"
 <openclaw-docs-sync[bot]@users.noreply.github.com>
Date: Fri, 24 Apr 2026 20:02:16 +0000
Subject: [PATCH] chore(sync): mirror docs from
 openclaw/openclaw@c997a9f9788e0a96e8eab05e7ae94959e76cdb4a

---
 .openclaw-sync/source.json |  4 ++--
 docs/gateway/index.md      | 36 ++++++++++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+), 2 deletions(-)

diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json
index cb27e3f61..233cb0a3d 100644
--- a/.openclaw-sync/source.json
+++ b/.openclaw-sync/source.json
@@ -1,5 +1,5 @@
 {
   "repository": "openclaw/openclaw",
-  "sha": "7536993397c69742facb1b2405f7743aa750924c",
-  "syncedAt": "2026-04-24T19:59:57.863Z"
+  "sha": "c997a9f9788e0a96e8eab05e7ae94959e76cdb4a",
+  "syncedAt": "2026-04-24T20:00:58.624Z"
 }
diff --git a/docs/gateway/index.md b/docs/gateway/index.md
index f561bacd0..446e2b67d 100644
--- a/docs/gateway/index.md
+++ b/docs/gateway/index.md
@@ -176,6 +176,42 @@ OPENCLAW_CONFIG_PATH=~/.openclaw/b.json OPENCLAW_STATE_DIR=~/.openclaw-b opencla
 
 Detailed setup: [/gateway/multiple-gateways](/gateway/multiple-gateways).
 
+## VoiceClaw real-time brain endpoint
+
+OpenClaw exposes a VoiceClaw-compatible real-time WebSocket endpoint at
+`/voiceclaw/realtime`. Use it when a VoiceClaw desktop client should talk
+directly to a real-time OpenClaw brain instead of going through a separate relay
+process.
+
+The endpoint uses Gemini Live for real-time audio and calls OpenClaw as the
+brain by exposing OpenClaw tools directly to Gemini Live. Tool calls return an
+immediate `working` result to keep the voice turn responsive, then OpenClaw
+executes the actual tool asynchronously and injects the result back into the
+live session. Set `GEMINI_API_KEY` in the gateway process environment. If
+gateway auth is enabled, the desktop client sends the gateway token or password
+in its first `session.config` message.
+
+Real-time brain access runs owner-authorized OpenClaw agent commands. Keep
+`gateway.auth.mode: "none"` limited to loopback-only test instances. Non-local
+real-time brain connections require gateway auth.
+
+For an isolated test gateway, run a separate instance with its own port, config,
+and state:
+
+```bash
+OPENCLAW_CONFIG_PATH=/path/to/openclaw-realtime/openclaw.json \
+OPENCLAW_STATE_DIR=/path/to/openclaw-realtime/state \
+OPENCLAW_SKIP_CHANNELS=1 \
+GEMINI_API_KEY=... \
+openclaw gateway --port 19789
+```
+
+Then configure VoiceClaw to use:
+
+```text
+ws://127.0.0.1:19789/voiceclaw/realtime
+```
+
 ## Remote access
 
 Preferred: Tailscale/VPN.