OpenClaw, también conocido como ClawdBot o MoltBot, puede ser utilizado si tienes un VPS solo con sistema operativo AlmaLinux 9 o Ubuntu 24.04 LTS y tienes conocimientos técnicos de comandos en el terminal. 

De lo contrario, recomendamos instalar la aplicación directamente a través del Portal del Cliente que automatiza todo el proceso - Consulta como adicionar

La instalación manual implica preparar el entorno del servidor, descargar los archivos necesarios y realizar la configuración inicial del modelo de inteligencia artificial.

Consulta a continuación:

• Etapa 1: Instalar Docker
• Etapa 2: Preparar el entorno de la aplicación
• Etapa 3: Configurar el cliente OpenClaw
• Etapa 4: Configurar el modelo de Inteligencia Artificial
• Solución de problemas

Etapa 1: Instalar Docker

El ClawdBot se ejecuta en contenedores Docker. Por lo tanto, el primer paso es verificar si Docker ya está instalado en el servidor.

1En terminal, escribe el comando:

docker –version 

Si Docker está instalado, el terminal mostrará la versión disponible.

En caso de que Docker no esté instalado, ejecuta el siguiente comando para instalar:

curl -fsSL https://get.docker.com | sh

2Una vez instalada, para iniciar Docker, escribe el comando:

systemctl start docker

3Una vez que hayas terminado, continúa a la Etapa 2

Etapa 2: Preparar el ambiente de la aplicación 

1Ahora será necesario crear el directorio donde se instalará ClawdBot, en el terminal, escribe el comando:

mkdir -p /docker/openclaw && cd /docker/openclaw

2OpenClaw utiliza un token de autenticación (código de seguridad usado para validar el acceso al sistema) para el acceso al gateway (servicio responsable de permitir la comunicación con el sistema).

Este token será generado automáticamente con el comando abajo:

echo -e "PORT=47716\nCLAWDBOT_GATEWAY_TOKEN=$(openssl rand -hex 32)" > /docker/openclaw/.env && cat /docker/openclaw/.env

3A continuación, guarda el token generado - se utilizará posteriormente para acceder al panel de OpenClaw

4Ahora, descarga los archivos del proyecto directamente del repositorio, para eso escribe los dos comandos:

• Archivo docker-compose.yml:

  • wget https://raw.githubusercontent.com/openclaw/openclaw/main/docker-compose.yml

• Archivo Dockerfile:

  • wget https://raw.githubusercontent.com/openclaw/openclaw/main/Dockerfile 

5Después de descargar los archivos, para crear la imagen generada en el Dockerfile, escribe:

docker compose build --no-cache

6Con la imagen creada, inicia el ambiente del ClawdBot:

docker compose up –d

7Ahora, sigue para la Etapa 3

Etapa 3: Configurar el cliente OpenClaw 

Para facilitar la ejecución de los comandos del ClawdBot, es necesario crear un cliente local, consulta cómo hacerlo:

1Para crear el archivo de acceso, escribe:

/usr/local/bin/openclaw

2Agrega el siguiente contenido al archivo:

#!/usr/bin/env bash 
set -euo pipefail 
 
CTR="moltbot-clawdbot-1" 
BIN="/app/node_modules/.pnpm/node_modules/.bin/clawdbot" 
 
exec docker exec -it \ 
  -u node \ 
  -e HOME=/home/node \ 
  -e XDG_CONFIG_HOME=/home/node/.clawdbot \ 
  "$CTR" "$BIN" "$@"

3Ahora concede permiso de ejecución al archivo:

chmod +x /usr/local/bin/openclaw

4Para verificar si el cliente fue configurado correctamente, escribe:

openclaw status

Si todo está correcto, el comando devolverá el estado del servicio.

Etapa 4: Configurar el modelo de Inteligencia Artificial 

Con el ambiente funcionando, el siguiente paso es configurar el modelo de IA que será utilizado por ClawdBot:

1En el terminal, ejecuta el proceso de configuración inicial de ClawBot:

clawbot onboard

2A continuación, selecciona la opción QuickStart

3Ahora, haz clic en el proveedor de IA – Por ejemplo: OpenAI, Gemini, etc.

4En "OpenIA auth method", haga clic en el método de autenticación - Por ejemplo: si elegiste OpenAI, selecciona OpenAI API Key (clave de acceso al servicio de OpenAI)

5A continuación, haz clic en el modelo deseado

6Opcionalmente, configura los canales de comunicación que podrán interactuar con el ClawdBot – Por ejemplo: Telegram, WhatsApp, Discord, etc.

7Después de seleccionar el modelo, será necesario insertar el token de autenticación del proveedor de IA, escribe:

openclaw models auth paste-token --provider NOMBRE_PROVIDER

Reemplaza NOMBRE_PROVIDER por el proveedor utilizado.

8Una vez finalizado, el acceso a OpenClaw ya será posible a través de la URL con el token generado en la etapa 2

Formato de la URL:

http://IP:47716/?token=TOKEN

Para generar esta URL automáticamente, ejecuta:

echo "http://$(hostname -I | cut -d' ' -f1| tr -d '\n'):47716/?token=$(grep '^CLAWDBOT_GATEWAY_TOKEN=' /docker/openclaw/.env | cut -d= -f2| tr -d '\n')"

Este comando mostrará directamente la dirección completa de acceso.

Solución de problemas 

A continuación se presentan algunos errores comunes y cómo corregirlos:

Error de Gateway: allowInsecureAuth = false

Si ocurre un error relacionado con el parámetro allowInsecureAuth, será necesario cambiar la configuración del gateway.

1Primero obtén el valor del parámetro HASH, ingresa en el  terminal:

gateway call config.get --params '{}'

2A continuación, copia el valor de HASH que aparece

3Después, ingresa el comando a continuación, sustituyendo HASH por el valor obtenido:

gateway call config.patch --params '{ 
   "raw": "{\n  \"gateway\": {\n    \"controlUi\": {\n      \"allowInsecureAuth\": true\n    }\n  }\n}", 
   "baseHash": "HASH" 
}'

Error de Gateway (bucle de reinicio)

Este error ocurre cuando el parámetro gateway.mode no está definido. En este escenario, el contenedor de Docker entra en un bucle de reinicio.

Para corregir: 

1Abre el archivo docker-compose.yml en modo de edición

2En la sección environment, añade la siguiente línea:

 GATEWAY_MODE=local

Por ejemplo:

3A continuación, solo tienes que reiniciar el contenedor, escribe:

docker compose down 
docker compose up -d

¡Listo! Después de completar estos pasos, el OpenClaw estará instalado y listo para su uso en tu VPS, lo que permite automatizar tareas e integrar agentes de inteligencia artificial al entorno de tu servidor.