Document Windows SSH access to OpenClaw
This commit is contained in:
+147
-1
@@ -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
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user