From a260be57dec6317bfe1914aa50b212514a5c5ce1 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Sun, 26 Apr 2026 04:03:59 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@b277eac656082954174def3a07c3b5df4481a943 --- .openclaw-sync/source.json | 4 ++-- docs/gateway/remote.md | 2 ++ docs/platforms/mac/remote.md | 5 +++++ 3 files changed, 9 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 5ab8665fe..823c4401b 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "9ed11d6c49d800075cf5e1e923c28826942a77c6", - "syncedAt": "2026-04-26T04:01:15.793Z" + "sha": "b277eac656082954174def3a07c3b5df4481a943", + "syncedAt": "2026-04-26T04:02:33.696Z" } diff --git a/docs/gateway/remote.md b/docs/gateway/remote.md index 49e86c183..eed33e7d3 100644 --- a/docs/gateway/remote.md +++ b/docs/gateway/remote.md @@ -98,6 +98,8 @@ You can persist a remote target so CLI commands use it by default: ``` When the gateway is loopback-only, keep the URL at `ws://127.0.0.1:18789` and open the SSH tunnel first. +In the macOS app’s SSH tunnel transport, discovered gateway hostnames belong in +`gateway.remote.sshTarget`; `gateway.remote.url` remains the local tunnel URL. ## Credential precedence diff --git a/docs/platforms/mac/remote.md b/docs/platforms/mac/remote.md index 2a0ab1b16..1af309b88 100644 --- a/docs/platforms/mac/remote.md +++ b/docs/platforms/mac/remote.md @@ -22,6 +22,11 @@ Remote mode supports two transports: - **SSH tunnel** (default): Uses `ssh -N -L ...` to forward the gateway port to localhost. The gateway will see the node’s IP as `127.0.0.1` because the tunnel is loopback. - **Direct (ws/wss)**: Connects straight to the gateway URL. The gateway sees the real client IP. +In SSH tunnel mode, discovered LAN/tailnet hostnames are saved as +`gateway.remote.sshTarget`. The app keeps `gateway.remote.url` on the local +tunnel endpoint, for example `ws://127.0.0.1:18789`, so CLI, Web Chat, and +browser automation all use the same safe loopback transport. + ## Prereqs on the remote host 1. Install Node + pnpm and build/install the OpenClaw CLI (`pnpm install && pnpm build && pnpm link --global`).