diff --git a/OPENCLAW_LOCAL_SERVER.md b/OPENCLAW_LOCAL_SERVER.md index fc94a0d..13de265 100644 --- a/OPENCLAW_LOCAL_SERVER.md +++ b/OPENCLAW_LOCAL_SERVER.md @@ -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 diff --git a/README.md b/README.md index 7446ab5..fa81689 100644 --- a/README.md +++ b/README.md @@ -97,6 +97,22 @@ openclaw doctor 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 Para ejecutar un diagnóstico independiente y de solo lectura del servidor usa