Document Windows SSH access to OpenClaw

2026-09-21 11:02:32 -03:00
parent 4a2a00966d
commit 2b3e0e605a
2 changed files with 163 additions and 1 deletions
@@ -269,7 +269,92 @@ logs del Gateway:
 openclaw logs --follow
 ```

-## 8. Usar OpenClaw desde otro equipo
+## 8. Acceder desde Windows con PuTTY o PowerShell
+
+En este servidor, la IP de la máquina Ubuntu es:
+
+```text
+192.168.0.225
+```
+
+El Gateway está enlazado intencionalmente a `127.0.0.1:18789`, por lo que no
+debes abrir `192.168.0.225:18789` directamente. Usa un túnel SSH desde el PC
+Windows.
+
+### PowerShell
+
+Ejecuta este comando en PowerShell del PC cliente:
+
+```powershell
+ssh -N -L 18789:127.0.0.1:18789 ctello@192.168.0.225
+```
+
+Introduce la contraseña de `ctello` y deja esa ventana abierta. El parámetro
+`-L` significa:
+
+```text
+Puerto local del PC:18789 -> servidor:127.0.0.1:18789
+```
+
+En otra ventana de PowerShell, comprueba el túnel:
+
+```powershell
+Test-NetConnection 127.0.0.1 -Port 18789
+```
+
+Debe mostrar:
+
+```text
+TcpTestSucceeded : True
+```
+
+Después abre el dashboard en el navegador del PC:
+
+```text
+http://127.0.0.1:18789
+```
+
+Si el puerto local `18789` ya está ocupado, usa otro puerto solo en el PC:
+
+```powershell
+ssh -N -L 18790:127.0.0.1:18789 ctello@192.168.0.225
+```
+
+En ese caso abre:
+
+```text
+http://127.0.0.1:18790
+```
+
+El destino remoto sigue siendo siempre `127.0.0.1:18789`.
+
+### PuTTY
+
+Configura la sesión con:
+
+```text
+Host Name: 192.168.0.225
+Port: 22
+Connection type: SSH
+```
+
+Después ve a `Connection > SSH > Tunnels` y añade:
+
+```text
+Source port: 18789
+Destination: 127.0.0.1:18789
+Type: Local
+```
+
+Pulsa `Add`, conecta la sesión y abre en el navegador:
+
+```text
+http://127.0.0.1:18789
+```
+
+Mantén abierta la sesión SSH mientras uses el dashboard.
+
+## 9. Usar OpenClaw desde otro equipo

 Si el Gateway corre en otro equipo distinto al servidor LLM, cambia únicamente
 `baseUrl` en `~/.openclaw/openclaw.json`:
@@ -316,6 +401,67 @@ una API key real ni TLS.

 ## Solución de problemas

+### Gateway activo, pero el navegador muestra `ERR_CONNECTION_REFUSED`
+
+Comprueba el estado en Ubuntu:
+
+```bash
+openclaw gateway status
+ss -ltnp | grep 18789
+```
+
+Debe aparecer:
+
+```text
+Runtime: running
+Connectivity probe: ok
+Listening: 127.0.0.1:18789
+```
+
+Si el Gateway no está activo, configura el modo local y arráncalo:
+
+```bash
+openclaw config set gateway.mode local
+openclaw gateway install
+openclaw gateway status
+```
+
+Si el servicio de usuario necesita una sesión persistente, habilita el
+`linger` para `ctello` desde una cuenta con `sudo`:
+
+```bash
+sudo loginctl enable-linger ctello
+```
+
+Después vuelve a iniciar sesión SSH como `ctello` y ejecuta:
+
+```bash
+systemctl --user daemon-reload
+systemctl --user enable --now openclaw-gateway.service
+```
+
+Si `systemctl --user` muestra que faltan `DBUS_SESSION_BUS_ADDRESS` o
+`XDG_RUNTIME_DIR`, vuelve a conectarte por SSH después de habilitar `linger`.
+No ejecutes un segundo `openclaw gateway run` si el servicio ya está activo.
+
+Para revisar errores:
+
+```bash
+journalctl --user -u openclaw-gateway.service -n 100 --no-pager
+```
+
+### El túnel de PowerShell no conecta
+
+En el PC cliente verifica primero que SSH funciona:
+
+```powershell
+Test-NetConnection 192.168.0.225 -Port 22
+```
+
+Si SSH responde pero el puerto del túnel no, comprueba en Ubuntu que el
+Gateway esté escuchando en `127.0.0.1:18789`. No abras el puerto `18789` en
+UFW ni cambies el Gateway a `0.0.0.0` solo para evitar el túnel.
+
 ### `Connection refused` en el puerto 8000

 ```bash