docs: fix remaining node ws references
This commit is contained in:
@@ -8,7 +8,7 @@ read_when:
|
|||||||
This repo supports “remote over SSH” by keeping a single Gateway (the master) running on a dedicated host (desktop/server) and connecting clients to it.
|
This repo supports “remote over SSH” by keeping a single Gateway (the master) running on a dedicated host (desktop/server) and connecting clients to it.
|
||||||
|
|
||||||
- For **operators (you / the macOS app)**: SSH tunneling is the universal fallback.
|
- For **operators (you / the macOS app)**: SSH tunneling is the universal fallback.
|
||||||
- For **nodes (iOS/Android and future devices)**: prefer the Gateway **Bridge** when on the same LAN/tailnet (see [Discovery](/gateway/discovery)).
|
- For **nodes (iOS/Android and future devices)**: connect to the Gateway **WebSocket** (LAN/tailnet or SSH tunnel as needed).
|
||||||
|
|
||||||
## The core idea
|
## The core idea
|
||||||
|
|
||||||
@@ -55,12 +55,12 @@ One gateway service owns state + channels. Nodes are peripherals.
|
|||||||
Flow example (Telegram → node):
|
Flow example (Telegram → node):
|
||||||
- Telegram message arrives at the **Gateway**.
|
- Telegram message arrives at the **Gateway**.
|
||||||
- Gateway runs the **agent** and decides whether to call a node tool.
|
- Gateway runs the **agent** and decides whether to call a node tool.
|
||||||
- Gateway calls the **node** over the Bridge (`node.*` RPC).
|
- Gateway calls the **node** over the Gateway WebSocket (`node.*` RPC).
|
||||||
- Node returns the result; Gateway replies back out to Telegram.
|
- Node returns the result; Gateway replies back out to Telegram.
|
||||||
|
|
||||||
Notes:
|
Notes:
|
||||||
- **Nodes do not run the gateway service.** Only one gateway should run per host unless you intentionally run isolated profiles (see [Multiple gateways](/gateway/multiple-gateways)).
|
- **Nodes do not run the gateway service.** Only one gateway should run per host unless you intentionally run isolated profiles (see [Multiple gateways](/gateway/multiple-gateways)).
|
||||||
- macOS app “node mode” is just a node client over the Bridge.
|
- macOS app “node mode” is just a node client over the Gateway WebSocket.
|
||||||
|
|
||||||
## SSH tunnel (CLI + tools)
|
## SSH tunnel (CLI + tools)
|
||||||
|
|
||||||
|
|||||||
@@ -95,8 +95,7 @@ clawdbot gateway --tailscale funnel --auth password
|
|||||||
- `gateway.bind: "tailnet"` is a direct Tailnet bind (no HTTPS, no Serve/Funnel).
|
- `gateway.bind: "tailnet"` is a direct Tailnet bind (no HTTPS, no Serve/Funnel).
|
||||||
- `gateway.bind: "auto"` prefers loopback; use `tailnet` if you want Tailnet-only.
|
- `gateway.bind: "auto"` prefers loopback; use `tailnet` if you want Tailnet-only.
|
||||||
- Serve/Funnel only expose the **Gateway control UI + WS**. Nodes connect over
|
- Serve/Funnel only expose the **Gateway control UI + WS**. Nodes connect over
|
||||||
the same Gateway WS endpoint, so Serve can work for node access. (Legacy TCP
|
the same Gateway WS endpoint, so Serve can work for node access.
|
||||||
bridge traffic is not proxied by Serve.)
|
|
||||||
|
|
||||||
## Browser control server (remote Gateway + local browser)
|
## Browser control server (remote Gateway + local browser)
|
||||||
|
|
||||||
|
|||||||
@@ -297,23 +297,9 @@ Notes:
|
|||||||
- On macOS, the headless node host prefers the companion app exec host when reachable and falls
|
- On macOS, the headless node host prefers the companion app exec host when reachable and falls
|
||||||
back to local execution if the app is unavailable. Set `CLAWDBOT_NODE_EXEC_HOST=app` to require
|
back to local execution if the app is unavailable. Set `CLAWDBOT_NODE_EXEC_HOST=app` to require
|
||||||
the app, or `CLAWDBOT_NODE_EXEC_FALLBACK=0` to disable fallback.
|
the app, or `CLAWDBOT_NODE_EXEC_FALLBACK=0` to disable fallback.
|
||||||
<<<<<<< HEAD
|
|
||||||
- Add `--tls` / `--tls-fingerprint` when the Gateway WS uses TLS.
|
- Add `--tls` / `--tls-fingerprint` when the Gateway WS uses TLS.
|
||||||
||||||| parent of 2ab821adc (docs: align node transport with gateway ws)
|
|
||||||
- Add `--tls` / `--tls-fingerprint` when the bridge requires TLS.
|
|
||||||
=======
|
|
||||||
- Add `--tls` / `--tls-fingerprint` when the gateway requires TLS.
|
|
||||||
>>>>>>> 2ab821adc (docs: align node transport with gateway ws)
|
|
||||||
|
|
||||||
## Mac node mode
|
## Mac node mode
|
||||||
|
|
||||||
<<<<<<< HEAD
|
|
||||||
- The macOS menubar app connects to the Gateway WS server as a node (so `clawdbot nodes …` works against this Mac).
|
- The macOS menubar app connects to the Gateway WS server as a node (so `clawdbot nodes …` works against this Mac).
|
||||||
- In remote mode, the app opens an SSH tunnel for the Gateway port and connects to `localhost`.
|
- In remote mode, the app opens an SSH tunnel for the Gateway port and connects to `localhost`.
|
||||||
||||||| parent of 2ab821adc (docs: align node transport with gateway ws)
|
|
||||||
- The macOS menubar app connects to the Gateway bridge as a node (so `clawdbot nodes …` works against this Mac).
|
|
||||||
- In remote mode, the app opens an SSH tunnel for the bridge port and connects to `localhost`.
|
|
||||||
=======
|
|
||||||
- The macOS menubar app connects to the Gateway WebSocket as a node (so `clawdbot nodes …` works against this Mac).
|
|
||||||
- In remote mode, the app opens an SSH tunnel for the gateway port and connects to `localhost`.
|
|
||||||
>>>>>>> 2ab821adc (docs: align node transport with gateway ws)
|
|
||||||
|
|||||||
@@ -728,7 +728,7 @@ Nodes don’t see inbound provider traffic; they only receive node RPC calls.
|
|||||||
### How can my agent access my computer if the Gateway is hosted remotely?
|
### How can my agent access my computer if the Gateway is hosted remotely?
|
||||||
|
|
||||||
Short answer: **pair your computer as a node**. The Gateway runs elsewhere, but it can
|
Short answer: **pair your computer as a node**. The Gateway runs elsewhere, but it can
|
||||||
call `node.*` tools (screen, camera, system) on your local machine over the Bridge.
|
call `node.*` tools (screen, camera, system) on your local machine over the Gateway WebSocket.
|
||||||
|
|
||||||
Typical setup:
|
Typical setup:
|
||||||
1) Run the Gateway on the always‑on host (VPS/home server).
|
1) Run the Gateway on the always‑on host (VPS/home server).
|
||||||
|
|||||||
Reference in New Issue
Block a user