Cómo implementar OpenClaw en una Máquina Virtual

Este artículo proporciona instrucciones paso a paso para implementar OpenClaw (anteriormente conocido como Clawdbot o Moltbot) en una Máquina Virtual (VM) de Spaceship. OpenClaw se implementa como un servicio Gateway de larga duración en la VM y se administra mediante la openclaw CLI y la interfaz de usuario de Control

Hablaremos de lo siguiente: 

  • Aprovisionamiento de una VM

  • Acceder a la VM

  • Instalación de requisitos previos (Node.js 22+)

  • Instalación de OpenClaw (se recomienda el instalador)

  • Ejecutar el asistente de incorporación e instalar el servicio Gateway

  • Acceso remoto seguro a la interfaz de usuario de Control mediante reenvío de puertos SSH                       

Primeros pasos

Antes de comenzar a implementar OpenClaw, asegúrate de haber configurado lo siguiente: 

  • Una cuenta de Spaceship - puedes hacerlo en spaceship.com

  • Una Máquina Virtual aprovisionada

  • Versiones más recientes de los sistemas operativos Ubuntu o Debian LTS

  • Node.js versión 22 o posterior

  • OAuth o claves API como credenciales de LLM - asegúrate de que sean compatibles con el asistente para una configuración más fluida

  • Credenciales de canal - datos de inicio de sesión para canales de mensajería como Slack, Telegram, Discord, etc. 

Paso 1: Compra y configura una VM

Si aún no lo has hecho, puedes comprar una VM en nuestro sitio web. La configuración es relativamente rápida e incluye solo unos pocos pasos:

  1. Selecciona un plan - para un rendimiento confiable, recomendamos el plan Standard 2 o superior.

  2. Selecciona un SO - las versiones más recientes de Ubuntu o Debian LTS son oficialmente compatibles con OpenClaw y se recomiendan por sus entornos estables y predecibles.

  3. Establece una contraseña root segura

  4. Agrega una clave SSH (opcional)

  5. Asigna un nombre a tu VM

    Para obtener más orientación, lee nuestra guía sobre cómo comprar y acceder a VMs. 

Una vez realizada la compra y completada la configuración, podrás acceder a VPS Manager, donde podrás administrar y modificar tu VM, así como implementar OpenClaw 

Obtén una prueba gratuita de 7 días con las VM prepagadas de Spaceship.

Paso 2: Accede al SSH de la VM

Ahora abre una sesión remota segura de línea de comandos en tu VM. Esto te ayudará a instalar y configurar OpenClaw directamente en el servidor. Conéctate por SSH en el puerto 22022 mediante el cliente SSH de tu elección (por ejemplo, Terminal, PuTTY).

Paso 3: Prepara el SO e instala Node.js 22+

3.1 Actualiza los paquetes del sistema

Usa el siguiente comando para buscar e instalar cualquier actualización de software:

apt update && apt upgrade -y

OpenClaw requiere Node.js versión 22 o superior. Sin embargo, Ubuntu/Debian no incluye Node.js de forma predeterminada. Primero tendrás que agregar NodeSource. Aquí tienes un desglose paso a paso:

  1. Usa el siguiente comando para instalar las herramientas necesarias para descargar archivos de internet de forma segura:

    apt install -y ca-certificates curl

  2. Agrega NodeSource a la lista de fuentes confiables de tu sistema:

    curl -fsSL https://deb.nodesource.com/setup_22.x | bash —

  3. Instala Node.js y npm ejecutando el siguiente comando:

    apt install -y nodejs

  4. Verifica que Node.js y npm se hayan instalado correctamente:

    node -v
    npm -v

Paso 4: Crea un usuario dedicado para OpenClaw

Es importante mantener las configuraciones, el campo de autenticación y los espacios de trabajo de OpenClaw separados de root. Puedes hacerlo agregando OpenClaw como un usuario dedicado. Esto ayudará a reducir el impacto si OpenClaw tiene un error, está mal configurado o es engañado por una entrada maliciosa.

Para crear un usuario dedicado, usa el siguiente comando:

adduser {UserName}

Luego agrega ese usuario al grupo sudo:

usermod -aG sudo {UserName}

Por último, cambia a ese usuario:

su - {UserName}

Recomendamos tratar tu espacio de trabajo de OpenClaw como un repositorio git: mantenlo desechable y recuperable para que puedas revertir cambios si el agente aprende un contexto incorrecto o contaminado, por ejemplo, mediante prompt injection. Siempre que sea posible, evita almacenar credenciales altamente sensibles en la máquina. 

Paso 5: Instala OpenClaw

Nota: Los comandos que se muestran en esta guía se proporcionan tal cual y reflejan el estado del proyecto al momento de redactarla. Debido a actualizaciones recientes de nombres y al desarrollo continuo, los nombres de los comandos y las opciones pueden cambiar. Para obtener la lista de comandos más actualizada y autorizada, consulta la fuente.

Ahora que hemos preparado el terreno, es momento de instalar OpenClaw.

La documentación de OpenClaw recomienda usar el instalador a menos que tengas una razón específica para no hacerlo. El instalador instala la CLI globalmente mediante npm y ejecuta la incorporación de forma predeterminada.

Para ejecutar el script de instalación e instalar OpenClaw automáticamente, usa el siguiente comando:  

curl -fsSL https://openclaw.bot/install.sh | bash

Paso 6: Ejecuta la incorporación e instala el servicio Gateway

6.1 Inicia la incorporación

OpenClaw recomienda usar el asistente de incorporación para la configuración. Entre otras cosas, configura el modelo/autenticación, los ajustes del gateway, los canales, los valores predeterminados de emparejamiento, el arranque del espacio de trabajo y un servicio en segundo plano (opcional).

La incorporación debería ejecutarse automáticamente después de la instalación. Si esto no sucede, o si la omitiste, vuelve a ejecutarla con: 

openclaw onboard --install-daemon

Durante la incorporación, elegirás:

  • Gateway local vs remoto - elige Local para la implementación en VM

  • Método de autenticación - OAuth o claves API

  • Credenciales de canal - inicio de sesión con código QR de WhatsApp, tokens de Telegram/Discord, etc. Recomendamos usar un número desechable para WhatsApp para aumentar la seguridad.

  • Instalación de daemon/servicio - launchd/systemd según la plataforma 

Se recomienda Node y es necesario para un funcionamiento confiable de WhatsApp/Telegram; Bun no se recomienda para el Gateway en estos casos.

Durante la incorporación, ten en cuenta estas mejores prácticas de seguridad: 

  • Solo otorga a OpenClaw acceso a recursos que te sentirías cómodo dando a un nuevo contratista en su primer día.

  • No otorgues a OpenClaw acceso a cuentas personales de alto valor como tu correo principal, cuentas bancarias o de corretaje.

  • Usa una dirección de correo electrónico dedicada para cualquier correo al que OpenClaw pueda acceder, en lugar de tu bandeja de entrada principal. 

6.2 Habilita la persistencia del servicio de usuario systemd

Las instalaciones de Linux usan un servicio de usuario systemd, que se detiene de forma predeterminada cuando un usuario cierra sesión, lo que termina el gateway.  Por lo tanto, debes habilitar lingering, que mantiene el servicio en segundo plano de OpenClaw en ejecución cuando el usuario ha cerrado sesión. 

La incorporación intenta habilitar lingering por ti y puede solicitar sudo. Sin embargo, si esto no sucede, puedes habilitar lingering ejecutando:

sudo loginctl enable-linger “$USER”

Paso 7: Acceso remoto seguro a la interfaz de usuario de Control 

De forma predeterminada, el Gateway de OpenClaw está configurado para vincularse a la interfaz loopback y accederse de forma remota mediante un túnel SSH o tailnet/VPN, en lugar de exponer un puerto público.

7.1 Identifica la IP de tu VM

En VPS Manager, abre la pestaña Máquina Virtual y haz clic en Manage para ver los detalles de VPS/red, incluida la dirección IP. 

7.2 Crea un túnel SSH desde tu estación de trabajo

Evita exponer la interfaz de usuario de Control a internet usando túneles SSH para reducir la superficie de ataque. Desde tu laptop/estación de trabajo (no la VM), ejecuta:

ssh -N -L 18789:127.0.0.1:18789 <username>@<vm-ip> -p 22022

Donde <vm-ip> es la IP pública de tu VM y <username> es el usuario dedicado que creaste en el paso 4.

7.3 Abre la interfaz de usuario de Control localmente

Para acceder a la interfaz de usuario de Control privada de OpenClaw, ejecuta el siguiente comando en tu VM:

openclaw dashboard

Esto generará una URL de inicio de sesión (por ejemplo, http://localhost:18789/?token=1234789) que puedes ingresar en tu navegador para acceder a la interfaz de usuario de Control y completar la incorporación. 

Una vez terminado, podrás comenzar a interactuar con OpenClaw en el canal de mensajería.

Paso 8 — Prueba de mensaje de extremo a extremo

El paso final es asegurarte de que OpenClaw funcione de extremo a extremo. Para enviar un mensaje de prueba, ejecuta: 

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

Si surgen problemas, ejecuta openclaw doctor y revisa cualquier advertencia antes de continuar. Antes de habilitar cualquier acción destructiva (por ejemplo, eliminar o sobrescribir archivos, cambiar permisos de usuario), revisa el comportamiento y las salidas del bot para asegurarte de que se comporte como se espera.

Se requiere un correo electrónico válido