2. VPS y dominio

En esta seccion configuramos el servidor donde se ejecutaran jaleo-api y OpenClaw. Necesitamos instalar Node.js, configurar el dominio y preparar el servidor.

Paso 1: Conectarse al VPS

Si usas Piensa Solutions, puedes conectarte por SSH:

ssh root@tu-ip-del-vps

Si acabas de crear el VPS, es buena idea actualizar el sistema:

apt update && apt upgrade -y

Paso 2: Instalar Node.js

Instalamos Node.js 22 (la version LTS actual) usando nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 22
node --version  # v22.x.x
npm --version   # 10.x.x

Tip

nvm te permite instalar y cambiar entre versiones de Node.js facilmente. Si en el futuro necesitas otra version, solo tienes que ejecutar nvm install <version>.

Paso 3: Instalar PM2

PM2 es un gestor de procesos para Node.js que mantiene tu aplicacion corriendo 24/7, se reinicia automaticamente si falla y muestra los logs:

npm install -g pm2

Lo usaremos mas adelante para ejecutar jaleo-api en segundo plano.

Paso 4: Instalar Caddy

Caddy es el reverse proxy que usaremos para obtener HTTPS automaticamente con Let’s Encrypt:

apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian/deb.txt' | tee /etc/apt/sources.list.d/caddy-stable.list
apt update
apt install caddy

Verifica que se instalo:

caddy version

Paso 5: Configurar el dominio

Asegurate de que tu dominio ya apunta a la IP del VPS. Puedes verificarlo con:

dig tudominio.com +short

Deberia devolver la IP de tu VPS.

Paso 6: Configurar Caddy

Edita el archivo /etc/caddy/Caddyfile:

nano /etc/caddy/Caddyfile

Y pon este contenido (reemplaza tudominio.com con tu dominio real):

tudominio.com {
    reverse_proxy localhost:8888 {
        header_up Host {host}
        header_up X-Real-IP {remote_host}
        header_up X-Forwarded-For {remote_host}
        header_up X-Forwarded-Proto {scheme}
    }
}

Reinicia Caddy:

systemctl restart caddy

Caddy obtendra automaticamente un certificado SSL de Let’s Encrypt y configurara HTTPS. La primera vez puede tardar unos segundos.

Tip

Si Caddy no arranca, revisa los logs con journalctl -u caddy --no-pager -n 50. Lo mas comun es que el dominio aun no apunte a la IP del VPS o que el puerto 80/443 este ocupado.

Paso 7: Verificar que HTTPS funciona

Abre tu navegador y ve a https://tudominio.com. Deberias ver un error de connexion (porque jaleo-api aun no esta corriendo), pero el certificado SSL deberia ser valido. Si ves el candado en la barra de direcciones, HTTPS esta funcionando.

Puedes verificar tambien con curl:

curl -I https://tudominio.com

Si ves HTTP/2 502 o similar, es correcto — significa que Caddy esta funcionando pero no hay nada escuchando en el puerto 8888 todavia. Eso lo arreglaremos en el siguiente paso.

Resumen del servidor preparado

| Componente | Estado | |-----------|--------| | Node.js 22 | Instalado | | PM2 | Instalado | | Caddy | Instalado y configurado | | Dominio | Apuntando al VPS | | HTTPS | Certificado SSL activo |

Siguiente: Instalar jaleo-api