Document Windows SSH access to OpenClaw

This commit is contained in:
Carlos Tello
2026-09-21 11:02:32 -03:00
parent 4a2a00966d
commit 2b3e0e605a
2 changed files with 163 additions and 1 deletions
+147 -1
View File
@@ -269,7 +269,92 @@ logs del Gateway:
openclaw logs --follow 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 Si el Gateway corre en otro equipo distinto al servidor LLM, cambia únicamente
`baseUrl` en `~/.openclaw/openclaw.json`: `baseUrl` en `~/.openclaw/openclaw.json`:
@@ -316,6 +401,67 @@ una API key real ni TLS.
## Solución de problemas ## 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 ### `Connection refused` en el puerto 8000
```bash ```bash
+16
View File
@@ -97,6 +97,22 @@ openclaw doctor
openclaw gateway status openclaw gateway status
``` ```
Para acceder al dashboard desde Windows mediante PowerShell, usa un túnel SSH
hacia el servidor Ubuntu:
```powershell
ssh -N -L 18789:127.0.0.1:18789 ctello@192.168.0.225
```
Mantén la sesión abierta y entra desde el navegador en:
```text
http://127.0.0.1:18789
```
La guía completa de acceso desde PuTTY, PowerShell y solución de problemas está
en [OPENCLAW_LOCAL_SERVER.md](OPENCLAW_LOCAL_SERVER.md).
## Respaldo y recuperación ## Respaldo y recuperación
Para ejecutar un diagnóstico independiente y de solo lectura del servidor usa Para ejecutar un diagnóstico independiente y de solo lectura del servidor usa