Cómo configurar Moltbot en un servidor privado

Configurar Moltbot (anteriormente conocido como Clawdbot) en un servidor privado implica preparar el entorno de tu VPS (Servidor Privado Virtual), clonar el repositorio de Moltbot, ejecutar el script de configuración de Docker, configurar las credenciales de su proveedor de IA y conectarlo a una plataforma de mensajería.

Es un proceso sencillo que lleva aproximadamente 30 minutos de principio a fin y, al final, tendrás tu propio asistente de IA respondiendo a mensajes 24/7.

Técnicamente puedes ejecutar Moltbot en tu propio portátil, pero eso tiene límites. Si cierras tu computadora o pierdes la conexión a Internet, tu bot se desconecta.

Por eso, ejecutarlo en un servidor privado es tan útil. Proporciona disponibilidad constante y ejecución en segundo plano, incluso cuando estás sin conexión, para que tu bot funcione 24/7 sin que tengas que estar pendiente de él.

1. Prepara un servidor privado para Moltbot

Para alistar un servidor privado para Moltbot, necesitas un VPS Linux con acceso administrativo completo. Esta es la base de tu proyecto porque un servidor siempre activo garantiza que tu bot nunca duerma.

No necesitas una supercomputadora para esto, pero sí cumplir con los requisitos específicos del servidor de Moltbot para garantizar la estabilidad.

Aquí tienes una lista de verificación para el servidor:

• Sistema operativo Linux (Ubuntu 22.04 o 24.04 funciona muy bien).
• Acceso administrativo (privilegios de root o sudo).
• Docker y Docker Compose.
• Al menos 2 GB de RAM (se recomiendan 4 GB para un mejor rendimiento).
• 10 GB o más de espacio en disco para imágenes de Docker, datos de la aplicación y registros.

Usaremos el hosting Moltbot de Hostinger para esta configuración, porque nuestro Docker Manager facilita las cosas, pero los mismos principios se aplican a cualquier otro proveedor de VPS.

Si eres completamente nuevo en la configuración de un VPS, revisa primero cómo configurar un VPS. Sigue la configuración inicial allí para asegurarte de que puedes conectarte por SSH a tu servidor.

2. Asegúrate de que Docker esté disponible en el VPS

Docker es la forma en que ejecutaremos Moltbot. Piensa en Docker como un contenedor que empaqueta todo lo que Moltbot necesita en una unidad ordenada. En lugar de instalar manualmente las dependencias y configurar distintos detalles, Docker se encarga de todo. Es más limpio, más fiable y mucho más fácil de gestionar.

Dentro del panel de control hPanel de Hostinger, busca el Administrador de Docker. Debería mostrar que Docker está instalado o darte la opción de habilitarlo. Ese es el camino más fácil.

Si estás en un VPS diferente o quieres verificar desde la línea de comandos, conéctate por SSH a tu servidor y ejecuta:

docker --version

docker compose version

Deberías ver números de versión tanto de Docker como de Docker Compose. Si aparece “command not found”, Docker aún no está instalado.

Una configuración adecuada de Docker para Moltbot depende de que el sistema de contenedores Docker funcione correctamente. Por lo tanto, para instalarlo manualmente, aprende cómo instalar Docker en Ubuntu y luego vuelve a verificarlo.

Una vez que Docker esté confirmado y en ejecución, estarás listo para el despliegue real de Moltbot.

3. Clona el repositorio de Moltbot

Ahora estamos llegando a lo bueno. Vamos a clonar el repositorio de Moltbot y usar el script oficial de configuración de Docker para compilar y desplegar todo.

Primero, debes obtener el código de Moltbot en tu servidor:

# Install git if you don't have it

sudo apt install git -y

# Clone the repository

git clone https://github.com/moltbot/moltbot.git

# Navigate into the directory

cd moltbot

Luego, ejecuta el script de configuración de Docker. Moltbot incluye un script de configuración que se encarga de todo automáticamente:

./docker-setup.sh

Este script de configuración es tu solución todo en uno para poner en marcha Moltbot. Esto es lo que hace:

1. Construye la imagen de Docker de Moltbot localmente (a partir del Dockerfile incluido).
2. Ejecuta el asistente de incorporación dentro de un contenedor de Docker.
3. Genera un token de puerta de enlace para acceder a la interfaz de usuario de control.
4. Crea los directorios de configuración necesarios.
5. Inicia la puerta de enlace de Moltbot mediante Docker Compose.

Todo el proceso está automatizado. A diferencia de muchas aplicaciones de Docker, en las que descargas una imagen preconstruida, Moltbot construye la imagen localmente en tu servidor. Esto significa que:

• Siempre estás ejecutando la versión exacta del repositorio.
• La primera compilación tarda unos minutos.
• Las reconstrucciones posteriores son más rápidas gracias a la caché de capas de Docker.
• Tienes control total sobre lo que se incluye.

4. Configura las credenciales y los ajustes de Moltbot

El script de configuración de Docker lanza un asistente interactivo de incorporación que configura Moltbot por ti. Aquí es donde configurarás las credenciales de tu proveedor de IA y otros ajustes esenciales.

Al ejecutar ./docker-setup.sh, después de construir la imagen, verás el asistente de incorporación. Plantea varias preguntas importantes:

Modo de puerta de enlace:

• Local (se ejecuta en esta máquina)
• Remoto (conectar con una puerta de enlace existente)

Elige local. Esto significa que la puerta de enlace se ejecuta en tu VPS.

Método de autenticación:

Esta es la parte más importante. Debes indicarle a Moltbot cómo acceder a los modelos de IA:

• Clave de API de Anthropic (recomendado)
• Clave de API de OpenAI
• OAuth (suscripción a Claude Pro/Max)
• OpenAI Code (suscripción a Codex)

Si optas por la opción recomendada de clave de API de Anthropic, entonces debes registrarte o iniciar sesión en Anthropic, ir a Claves de API, crear una nueva clave, copiarla y pegarla en el asistente de configuración.

Mantén esta clave segura. Cualquiera que tenga esta clave puede usar Claude en tu cuenta y se te cobrará por su uso.

El proceso es el mismo con las otras opciones: obtienes una clave de la plataforma de IA y la añades a la configuración. El asistente almacena estas credenciales como variables de entorno de Linux en tus archivos de configuración.

Luego eliges el modelo para la plataforma de IA seleccionada y seleccionas la configuración de seguridad.

El error de configuración más común de Moltbot es la falta de una clave de API. Sin una clave de API válida de Anthropic u OpenAI, Moltbot no funcionará. Tanto Anthropic como OpenAI requieren un método de pago registrado para el acceso a la API, así que asegúrate de que tu clave de API esté activa y tenga la facturación configurada.

5. Inicia Moltbot y verifique que esté en ejecución

Una vez que el script de configuración haya finalizado, Moltbot ya debería estar ejecutándose.

Para verificar que todo esté funcionando correctamente, revisa el estado del contenedor:

# Make sure you're in the moltbot directory

cd ~/moltbot

# Check running containers

docker compose ps

Deberías ver moltbot-gateway con el estado “Up” o “Running”. Otros indicios de que todo está funcionando correctamente incluyen ver:

• Un mensaje de “Moltbot initialized”
• Proveedor de modelos conectado (Anthropic/OpenAI)
• Sin errores de autenticación

Por otro lado, si ves “Clave de API no válida”, “Autenticación fallida”, “Conexión rechazada” o si el contenedor simplemente sigue reiniciándose, entonces tienes un error.

Detente aquí y corrígelos antes de continuar revisando los registros:

docker compose logs moltbot-gateway

Esto es importante para la solución de problemas. Los registros de Moltbot te indican lo que el bot está haciendo en realidad, para que puedas abordar los problemas.

6. Accede a la interfaz de Moltbot

El panel de control de Moltbot es accesible a través de la dirección IP de tu VPS en el puerto 18789:

http://ip-de-tu-vps:18789

Por ejemplo: http://45.123.45.67:18789

Cuando visites por primera vez la interfaz de usuario de Control, necesitarás el token de la puerta de enlace que se generó durante la configuración. Encuéntralo en:

cat ~/.clawdbot/.env | grep CLAWDBOT_GATEWAY_TOKEN

O revisa la salida de cuando ejecutaste ./docker-setup.sh – muestra el token al final.

Nota: aunque el proyecto ha sido renombrado a Moltbot, los archivos y directorios de configuración aún usan la denominación “clawdbot” (como ~/.clawdbot/ y CLAWDBOT_GATEWAY_TOKEN). Esto es normal durante la transición y no afecta la funcionalidad.

Una vez que estés en el panel de control, ve a Configuración → Token (o puede que se te pida de inmediato). Pega tu token de la pasarela, luego haz clic en Guardar o Autenticar.

Esta interfaz de Moltbot es tu centro de control. No necesitas configurar todo ahora mismo. Solo confirma que puedes acceder a él y que Moltbot se muestre en buen estado.

Si no puede acceder a la interfaz, sigue estos pasos de solución de problemas:

• Comprueba que el contenedor esté realmente en ejecución: docker compose ps
• Verifica que tu cortafuegos no esté bloqueando el puerto
• Asegúrate de usar HTTP, no HTTPS
• Intenta acceder desde el propio servidor en la línea de comandos: curl http://localhost:18789

7. Conecta un canal de mensajería a Moltbot

El panel web que acabamos de configurar es para la administración, pero interactuarás con Moltbot a través de una aplicación de mensajería donde tienen lugar las conversaciones de IA.

Repasaremos cómo configurar todo con Telegram, ya que es sencillo, pero el proceso es similar para otras plataformas.

A continuación te explicamos cómo manejar una configuración de Moltbot en Telegram:

Paso 1: crear un bot de Telegram

1. Abre Telegram y busca @BotFather
2. Inicia un chat y envía /newbot
3. Sigue las indicaciones:
   • Elige un nombre (por ejemplo, Mi asistente Moltbot)
   • Elige un nombre de usuario (debe terminar en “bot”, como “migenialmoltbot”).
4. BotFather te dará un token de bot. Copia esto.

Paso 2: añadir Telegram a Moltbot

De vuelta en tu servidor, ejecuta:

# Make sure you're in the moltbot directory

cd ~/moltbot

# Add Telegram with your bot token

docker compose run --rm moltbot-cli providers add --provider telegram --token YOUR_BOT_TOKEN

Reemplaza YOUR_BOT_TOKEN con el token real de BotFather.

Paso 3: habilitar los permisos necesarios del bot

En el chat de BotFather:

1. Envía /mybots
2. Selecciona tu bot
3. Ve a Configuración del bot → Privacidad de grupos
4. Desactivar la privacidad del grupo (esto permite que el bot lea los mensajes en los grupos)

Paso 4: comenzar a chatear

1. Abre Telegram y busca tu bot (por el nombre de usuario que elegiste)
2. Inicia una conversación
3. Envía un mensaje para probarlo

Si configuras el emparejamiento de DM durante la configuración, recibirás un código de emparejamiento. En tu servidor, apruébalo:

docker compose run --rm moltbot-cli pairing approve telegram <el-código-que-recibiste>

Después de la aprobación, envía otro mensaje. ¡Moltbot debería responder!

Si los mensajes no funcionan en tu configuración de Moltbot en Telegram:

• Revisa los registros de Moltbot en busca de errores.
• Verifique que las claves de API sigan siendo válidas.
• Asegúrate de que el contenedor no se haya reiniciado ni se haya bloqueado.
• Confirma que tus credenciales de la plataforma de mensajería son correctas.

Cómo solucionar problemas comunes de configuración de Moltbot

Para solucionar problemas comunes al configurar Moltbot, primero comprueba el estado del contenedor, verifica tu token de la pasarela y examina los registros en busca de mensajes de error específicos. La mayoría de los problemas se encuadran en unas pocas categorías previsibles y, una vez que sabes qué buscar, se solucionan rápidamente.

Estos son los problemas más comunes que podrías encontrar cuando Moltbot no funciona.

El contenedor sigue deteniéndose

Si tu contenedor se inicia y luego se detiene inmediatamente:

1. Comprueba el estado de los contenedores: docker compose ps
2. Ver los registros en busca de errores: docker compose logs moltbot-gateway
3. Busca el error específico: docker compose logs moltbot-gateway | grep -i “error”

Las causas comunes incluyen una clave de API ausente o no válida, el puerto 18789 ya en uso, problemas de configuración de Docker Compose o permisos insuficientes.

Errores de autenticación

El problema más común con diferencia. Si ves “authentication failed”, “invalid API key” o si las solicitudes al modelo fallan, entonces verifica tu clave de API:

cat ~/.clawdbot/.env

Busca ANTHROPIC_API_KEY o OPENAI_API_KEY. Asegúrate de:

• La clave está presente y no está vacía.
• No hay espacios ni comillas de más.
• La clave no ha sido revocada ni ha caducado.

También necesitas verificar que la clave sea válida en el panel de la plataforma de IA y comprobar el estado de facturación, ya que tanto Anthropic como OpenAI requieren facturación activa.

Luego vuelve a añadir tus credenciales:

# Edit the .env file

nano ~/.clawdbot/.env

# Add or update your API key

ANTHROPIC_API_KEY=your_actual_key_here

# Restart the gateway

docker compose restart moltbot-gateway

Conflictos de puertos

Si obtienes errores de “port already in use” o “address already in use”:

• Comprueba qué está usando el puerto: sudo lsof -i :18789
• Cambia el puerto de Moltbot editando docker-compose.yml
• Utiliza un mapeo de puertos diferente: -p 18790:18789

Bucles de reinicio de contenedores

Si el contenedor sigue reiniciándose, por lo general significa que faltan variables de entorno, hay archivos de configuración corruptos, una configuración de modelo no válida o problemas de permisos.

Para solucionar esto:

• Detén todo: docker compose down
• Elimina contenedores y volúmenes antiguos: docker compose down -v
• Reconstruye y reinicia: ./docker-setup.sh

No se puede acceder a la interfaz

Si el contenedor está en ejecución pero no puedes acceder al panel de control:

• Comprueba las reglas del cortafuegos y permite el puerto 18789: sudo ufw allow 18789/tcp
• Verifica que el contenedor esté escuchando: curl http://localhost:18789
• Verifica la configuración del proveedor de VPS, ya que algunos proveedores requieren que configures grupos de seguridad para permitir el tráfico entrante en el puerto 18789.

Reinicio de forma segura

Deberás reiniciar Moltbot cuando cambies las variables de entorno, si el bot deja de responder o después de actualizaciones específicas de configuración.

Un reinicio también es útil para solucionar comportamientos extraños, ya que un inicio limpio puede resolver problemas que no muestran errores evidentes en los registros.

Si necesitas reiniciar Moltbot rápidamente sin detener primero el contenedor:

docker restart moltbot-gateway

O para un reinicio limpio en el que detienes manualmente y luego vuelves a iniciar el contenedor (útil cuando quieres tener más control sobre el proceso o necesitas verificar que el contenedor se detenga por completo):

docker stop moltbot-gateway

docker start moltbot-gateway

Las mejores prácticas para ejecutar Moltbot

Buenas prácticas para ejecutar Moltbot incluyen mantener seguro el token de puerta de enlace, supervisar regularmente el uso de recursos y mantenerse al día con las actualizaciones.

Operar un bot de IA en un servidor implica responsabilidades, pero son manejables si estableces buenos hábitos desde el principio en áreas específicas.

Prácticas de seguridad

• Nunca compartas tu token de la puerta de enlace: trátalo como si fuera una contraseña, porque cualquiera que lo tenga puede controlar tu bot.
• Utiliza un cortafuegos: expón únicamente los puertos que realmente necesites (como el puerto 18789 para la interfaz).
• Mantén SSH seguro: utiliza la autenticación basada en claves en lugar de contraseñas para acceder al servidor.
• Restringe el acceso a la interfaz: considera usar una VPN o una lista de permitidos de IP si no necesitas acceso público al panel.

Gestión de recursos

Moltbot es relativamente ligero, pero aun así deberías estar atento a:

• Uso de memoria: comprueba ocasionalmente con docker stats moltbot-gateway
• Espacio en disco: los registros pueden acumularse. Considera la rotación de archivos de registro si se ejecuta a largo plazo.
• Uso de la CPU: los picos son normales durante conversaciones activas, pero un uso elevado sostenido podría indicar un problema.

Si detectas problemas de recursos, es posible que debas actualizar tu VPS o investigar qué está causando un uso excesivo.

Estrategia de actualización

Periódicamente se publican nuevas versiones de Moltbot con mejoras y correcciones.

• Comprueba si hay actualizaciones cada mes (o suscríbete a los anuncios de Moltbot).
• Prueba primero las actualizaciones en un entorno que no sea de producción, si es posible.
• Haz una copia de seguridad de tu configuración de trabajo actual antes de actualizar.
• Lee las notas de la versión para entender qué ha cambiado.

Supervisión del tiempo de actividad

Configura un monitoreo básico para saber si Moltbot se cae:

• La política de reinicio de Docker ayuda con la recuperación automática.
• Considera un monitor sencillo de tiempo de actividad (existen muchos servicios gratuitos).
• Revisa los registros periódicamente en busca de errores o advertencias inusuales.
• Prueba tus canales de mensajería ocasionalmente para confirmar su funcionamiento.

Configuración de copia de seguridad

Tus variables de entorno (especialmente ese token de gateway) son esenciales para la configuración. Documéntalos de manera segura:

• Guarda tu token en un gestor de contraseñas.
• Lleva un registro de tus ajustes de configuración.
• Documenta cualquier variable de entorno personalizada que hayas añadido.

Cómo administrar Moltbot después de la configuración

Para gestionar Moltbot después de la configuración, supervisa los registros con regularidad, actualiza el contenedor cuando se publiquen nuevas versiones y vigila las métricas de rendimiento.

La gestión diaria es mínima una vez que todo marcha sin problemas, pero un poco de atención continua mantiene todo en buen estado. Esto es lo que debes hacer.

Revisa los registros con regularidad

Convierte en un hábito echar un vistazo a los registros cada semana usando:

docker compose logs --tail 100 moltbot-gateway

Busca errores o advertencias repetidos, problemas de rendimiento, problemas de conexión o patrones inusuales.

La mayoría de las veces verás un funcionamiento normal, pero detectar los problemas a tiempo evita problemas mayores.

Actualiza Moltbot

Cuando se lance una nueva versión, utilizas el script de instalación para obtener el código más reciente:

git pull

Luego vuelve a ejecutar la instalación (esto conserva tu configuración):

./docker-setup.sh

Monitoriza el tiempo de actividad

Comprueba el estado del contenedor periódicamente. Debería mostrar el estado como “Up”, pero si se reinicia con frecuencia, investiga los registros.

Supervisa el rendimiento

Cada pocas semanas, verifica el uso de recursos:

docker stats moltbot-gateway

Esto muestra el uso de la CPU, la memoria y la red en tiempo real. Si el uso parece elevado, es posible que debas:

• Investigar qué lo está causando (revisa los registros).
• Amplíar tu VPS si las especificaciones actuales se te han quedado cortas.
• Optimizar tu configuración.

No necesitas preocuparte por el escalado, la agrupación en clústeres ni por optimizaciones complejas en la mayoría de los casos de uso. Moltbot funciona bien en un solo VPS para uso personal o de equipos pequeños.

Céntrate en mantenerlo funcionando de forma fiable, actualizarlo cuando sea necesario, supervisar los errores y mantener los aspectos básicos de seguridad.

Para una referencia rápida de los comandos de Docker que usarás al administrar Moltbot, consulta esta guía de comandos Docker.

All of the tutorial content on this website is subject to Hostinger's rigorous editorial standards and values.