Tutoriales de VPS
Tutorial para instalar OpenClaw en un VPS (2026): despliegue en servidor cloud Ubuntu, acceso por túnel SSH y errores comunes
Si quieres ejecutar OpenClaw en un servidor cloud a largo plazo, la clave no es terminar de escribir los comandos, sino configurar correctamente de una vez el entorno de ejecución, el servicio en segundo plano, el método de acceso y el límite de seguridad. Este artículo sigue el flujo real de despliegue en un VPS Ubuntu y te guía para completar la instalación de OpenClaw, el arranque del daemon, el acceso por túnel SSH, la verificación básica y la resolución de errores comunes.

Si quieres que OpenClaw esté en línea 24/7, desplegarlo en un VPS suele ser más estable que tenerlo en tu computadora local.
La documentación oficial ya admite esta ruta de forma bastante completa: un VPS Linux puede ejecutar directamente OpenClaw Gateway y luego acceder a la interfaz de control desde tu portátil mediante un túnel SSH u otro método controlado. La ventaja es que el espacio de trabajo, el estado y el servicio en segundo plano permanecen en el servidor, y no se interrumpen porque cierres el portátil o porque fluctúe tu red local.
Este artículo está escrito para un VPS Ubuntu típico, con un objetivo claro:
- Instalar OpenClaw en un servidor cloud
- Mantener el Gateway ejecutándose de forma permanente como servicio en segundo plano
- Acceder de forma segura a la interfaz de control desde un navegador local
- Resolver de paso los errores más comunes durante la instalación
Antes de empezar, necesitas al menos lo siguiente:
- Un VPS Ubuntu
- Un usuario normal que pueda iniciar sesión por SSH
- Que el servidor pueda acceder a internet con normalidad
- Que tu computadora local también pueda usar el comando
ssh
Según las preguntas frecuentes oficiales, el requisito mínimo de OpenClaw en un VPS no es alto, pero se recomienda preparar al menos una máquina con 1-2 vCPU / 2GB RAM. Para el sistema, prioriza Ubuntu LTS o una distribución basada en Debian.
Si solo lo estás probando, una configuración baja también puede arrancarlo; si más adelante vas a conectar más canales y ejecutar más espacios de trabajo, conviene no quedarte demasiado corto de memoria desde el principio.
Primero inicia sesión en el servidor:
ssh your-user@your-server-ip
Una vez conectado, haz primero una actualización del sistema:
sudo apt update && sudo apt upgrade -y
Luego instala algunas herramientas básicas:
sudo apt install -y curl git unzip ca-certificates
Este paso parece normal, pero es importante. Muchos fallos de instalación posteriores se deben en esencia a que el sistema es demasiado antiguo, los certificados están incompletos o faltan comandos básicos como curl y git.
OpenClaw recomienda oficialmente Node 24 en la actualidad, y también es compatible con la versión más reciente Node 22 LTS. Para un VPS, la forma más segura es instalar directamente una versión más reciente compatible con la oficial, en lugar de seguir usando el Node posiblemente más antiguo de los repositorios de Ubuntu.
Si tu máquina aún no tiene Node, compruébalo primero:
node -v
npm -v
Si no está instalado, o la versión es demasiado antigua, puedes instalar Node 24 mediante NodeSource:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
Después de la instalación, confirma la versión una vez más:
node -v
npm -v
Si aquí se muestra Node 24, puedes continuar.
Si quieres la ruta más corta, puedes ejecutar directamente el script de instalación oficial:
curl -fsSL https://openclaw.ai/install.sh | bash
Este método es adecuado para quienes quieren ponerlo en marcha cuanto antes.
Si prefieres controlar cada paso tú mismo, también puedes instalar globalmente con npm directamente:
npm install -g openclaw@latest
Después de la instalación, confirma que el comando ya está disponible:
openclaw --version
Si aquí se muestra correctamente el número de versión, significa que la instalación del CLI se ha realizado con éxito.
El punto de entrada de inicialización recomendado oficialmente por OpenClaw no es armar manualmente un montón de configuración, sino ejecutar directamente:
openclaw onboard --install-daemon
Este comando te guiará por la configuración inicial y, de paso, instalará el Gateway como servicio en segundo plano.
Puedes entenderlo como hacer dos cosas a la vez:
- Completar la primera configuración de OpenClaw
- Registrar el Gateway como servicio de usuario de systemd para que siga ejecutándose después de salir de la terminal
Durante este proceso, normalmente encontrarás estas entradas clave:
- Puerto de escucha del Gateway
- Método de autenticación de acceso
- Shared secret o token
- Configuración de inicialización del espacio de trabajo o del perfil
Se recomienda anotar primero el token o la contraseña, ya que los necesitarás al acceder desde el navegador local más adelante.
Después de la inicialización, no te apresures a abrir la interfaz en local; primero confirma el estado del servicio en el servidor.
Puedes revisar primero el proceso o el servicio:
systemctl --user status openclaw-gateway
Si el nombre de tu servicio lleva un sufijo de perfil, también podría ser un nombre como este:
systemctl --user status openclaw-gateway-yourprofile
Si quieres ver los registros:
journalctl --user -u openclaw-gateway -f
O el nombre de servicio correspondiente a tu propio perfil.
En condiciones normales, deberías ver que el Gateway está escuchando en el puerto predeterminado 18789 y que el estado del servicio es running.
Si el flujo de instalación anterior no se instaló correctamente de forma automática, también puedes ejecutarlo manualmente otra vez:
openclaw gateway install
O volver a ejecutar:
openclaw doctor
La documentación oficial también considera doctor como el primer punto de entrada de diagnóstico en escenarios de reparación y migración.
Este es el paso más crítico del despliegue en VPS, y también el más fácil de pasar por alto.
Muchas personas, en cuanto instalan el servicio, quieren exponer directamente el puerto 18789 a la internet pública. Pero la forma que recomienda la documentación oficial es primero hacer que el Gateway escuche solo en la dirección de loopback local y luego acceder desde tu propia computadora mediante un túnel SSH.
Ejecuta en tu computadora local:
ssh -N -L 18789:127.0.0.1:18789 your-user@your-server-ip
El significado de este comando es:
- Reenviar tu
127.0.0.1:18789local - Hacia
127.0.0.1:18789en el VPS
Luego abre en tu navegador local:
http://127.0.0.1:18789/
Verás la interfaz de control de OpenClaw y luego introduce el token o la contraseña configurados en la etapa openclaw onboard.
Las ventajas de esta ruta son muy directas:
- No es necesario exponer el puerto de administración directamente a la internet pública
- El límite de seguridad es más claro
- Adecuado para uso a largo plazo por individuos o equipos pequeños
Si más adelante realmente necesitas un acceso remoto más permanente, considerar Tailscale u otras soluciones de red más completas sería más razonable.
Poder abrir la interfaz de control no significa que la instalación ya esté completamente operativa; conviene hacer otra capa de verificación.
Puedes probar los siguientes comandos en el servidor:
openclaw doctor
Si solo quieres confirmar si el Gateway puede arrancar en primer plano, también puedes ejecutar temporalmente:
openclaw gateway --port 18789 --verbose
Si ya has completado la configuración relacionada con modelos o canales, también puedes seguir con una verificación funcional más avanzada, como enviar un mensaje de prueba o iniciar una conversación simple con el agente.
Pero para un tutorial de instalación, con este paso ya es suficiente para determinar:
- El entorno Node es normal
- El CLI de OpenClaw está disponible
- El Gateway se ha desplegado correctamente
- Se puede acceder de forma segura desde local mediante túnel SSH
Si solo estás probando la instalación por primera vez, el método Node + npm + onboard anterior ya es suficiente.
Pero si planeas ejecutar OpenClaw como servicio permanente a largo plazo en un VPS, la ruta Docker también vale la pena considerarla, especialmente en los siguientes casos:
- Quieres una forma de ejecución más unificada
- Ya tienes hábitos establecidos de operación con Docker
- Quieres gestionar con más claridad los directorios de datos y el proceso de actualización
La documentación oficial ya ofrece una solución Docker Compose para el escenario de Hetzner, cuya idea central es persistir estos directorios:
~/.openclawworkspace- Posiblemente también otros directorios de caché del entorno de ejecución
Si más adelante vas a escribir un plan de despliegue más orientado a producción, puedes perfectamente ampliar este artículo en un artículo de "Despliegue de OpenClaw con Docker".
Esto normalmente indica que el directorio global de instalación de npm no está en el PATH del shell actual, o que la instalación simplemente no se realizó correctamente.
Comprueba primero:
npm root -g
npm bin -g
Luego confirma si el directorio correspondiente ya se ha añadido a PATH.
Si lo instalaste mediante el script de instalación, también se recomienda abrir una nueva sesión de shell y volver a intentarlo.
Si ves un error en tiempo de ejecución, comprueba primero la versión de Node:
node -v
OpenClaw recomienda oficialmente Node 24 en la actualidad. El Node de los repositorios predeterminados de Ubuntu suele ser demasiado antiguo y no se recomienda usarlo directamente.
En este caso, normalmente conviene revisar primero 3 cosas:
- Si el Gateway en el VPS realmente está en ejecución
- Si tu comando de túnel SSH sigue conectado
- Si el puerto está mal escrito
El problema más común no es que OpenClaw no se haya iniciado, sino que cerraste la sesión SSH, lo que hizo que el reenvío local dejara de funcionar.
Técnicamente es posible, pero no se recomienda hacerlo de entrada.
Si no has limitado claramente el modo de autenticación, la dirección de escucha y el origen de acceso, equivale a exponer directamente el plano de administración. Para despliegues personales, un túnel SSH suele ser suficiente.
Si solo ejecutaste openclaw gateway --port 18789 en primer plano, entonces, por supuesto, se detiene después de que salgas del shell.
Para ejecutarlo a largo plazo, deberías usar:
openclaw onboard --install-daemon
O:
openclaw gateway install
Luego usa systemctl --user para confirmar el estado del servicio.
Si solo quieres poner OpenClaw en marcha en un VPS, la ruta más segura en realidad no es complicada:
- Preparar un VPS Ubuntu
- Instalar Node 24
- Instalar el CLI de OpenClaw
- Ejecutar
openclaw onboard --install-daemon - Acceder a
127.0.0.1:18789mediante túnel SSH
Esta ruta es más adecuada para la mayoría de usuarios individuales que "exponer directamente el puerto público", y también se ajusta más a la forma recomendada oficialmente por OpenClaw para el despliegue en VPS.
Si más adelante planeas ejecutarlo a largo plazo, conectar varios dispositivos o añadir más tareas de automatización, seguir con la dockerización, el acceso remoto y las estrategias de copia de seguridad será más estable.
El siguiente paso más práctico no es seguir leyendo tutoriales, sino poner en marcha tu propio VPS primero y luego usar openclaw doctor para hacer una comprobación completa.