¿Te imaginas tener un asistente de IA que responda tus emails, gestione tu calendario, filtre llamadas y haga reservaciones por ti, todo desde WhatsApp o Telegram? Eso es exactamente lo que promete Moltbot, el proyecto open source que está revolucionando cómo interactuamos con la inteligencia artificial.
En este tutorial te mostraré cómo instalar Moltbot en tu propio servidor Linux, manteniendo el control total de tus datos y sin depender de servicios de terceros.
🤖 ¿Qué es Moltbot?
Moltbot (anteriormente conocido como Clawdbot) es un asistente personal de IA creado por Peter Steinberger, el desarrollador austríaco fundador de PSPDFKit. A diferencia de los chatbots tradicionales que esperan tus comandos, Moltbot es:
- Proactivo: Actúa sin que tengas que pedírselo constantemente
- Autónomo: Se integra profundamente en tu flujo de trabajo diario
- Multiplataforma: Lo controlas desde WhatsApp, Telegram, Discord, Slack o Signal
- Open Source: Licencia MIT, 100% tuyo
Nota: El proyecto cambió de nombre de Clawdbot a Moltbot por un supuesto conflicto de marca con Claude de Anthropic. También se le conoce como OpenClaw.
⚠️ Advertencia de Seguridad
Antes de continuar, debo ser honesto contigo: Moltbot ha generado controversia en la comunidad de seguridad.
Investigadores descubrieron que cientos de instancias mal configuradas quedaron expuestas en internet, filtrando:
- API keys y tokens
- Secretos OAuth
- Historiales de conversación completos
- Capacidad de ejecutar comandos
En una demostración, un investigador logró que un Moltbot vulnerable reenviara emails a un atacante en solo 5 minutos.
¿La lección? Este tutorial incluye las mejores prácticas de seguridad. Síguelas al pie de la letra.
🔧 Requisitos
| Componente | Mínimo |
|---|---|
| Sistema Operativo | Linux (Ubuntu/Debian recomendado) o WSL2 en Windows |
| Node.js | Versión 22 o superior |
| RAM | Mínima (el Gateway consume muy poco) |
| Almacenamiento | ~500MB para la instalación |
También necesitarás:
- Una API key de Anthropic (Claude), OpenAI, o tu proveedor LLM preferido
- Acceso a una app de mensajería (Telegram, WhatsApp, Discord, etc.)
🛠 Instalación Paso a Paso
Paso 1: Actualizar el Sistema
sudo apt update && sudo apt upgrade -y¿Qué hace esto? Actualiza la lista de paquetes y todos los paquetes instalados a sus versiones más recientes.
Paso 2: Instalar Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejsVerifica la instalación:
node --versionDeberías ver v22.x.x o superior.
Paso 3: Instalar pnpm (Gestor de Paquetes)
npm install -g pnpmPaso 4: Clonar e Instalar Moltbot
Opción A: Instalación Rápida (Recomendada)
curl -fsSL https://clawd.bot/install.sh | bash
exec bash¿Qué hace esto? Descarga el script de instalación oficial, configura todo automáticamente y reinicia tu shell para cargar la configuración.
Opción B: Instalación Manual
git clone https://github.com/moltbot/moltbot.git
cd moltbot
pnpm install
pnpm ui:build
pnpm build
Paso 5: Ejecutar el Asistente de Configuración
Nota: El asistente ofrece modo QuickStart (configuración recomendada) o Advanced (control total). Para la mayoría de usuarios, QuickStart es suficiente.
Paso 6: Configurar tu API Key
Durante el onboarding, necesitarás proporcionar tu API key. Por ejemplo, para Claude de Anthropic puedes usar tu API o auth method para usar tu cuenta de Claude Pro
Paso 7: Conectar un Canal de Mensajería
Moltbot soporta múltiples canales. Para Telegram:
En este paso, Moltbot te pedirá el Telegram bot token, una clave privada que permite al asistente conectarse con la API de Telegram.
Para obtenerlo:
- Abre Telegram y busca @BotFather
- Ejecuta el comando
/newbot - Sigue las instrucciones para nombrar tu bot
- BotFather te entregará un token con formato
123456:ABC... - Copia ese token y pégalo en el instalador
⚠️ Este token es secreto. No lo compartas ni lo expongas públicamente.
Nota: Si usas WhatsApp o Telegram, ejecuta el Gateway con Node en lugar de Bun (hay problemas conocidos).
Configuración de Skills (capacidades del agente)
Después de conectar OpenClaw con Telegram, el instalador recomienda configurar los skills.
En OpenClaw, un skill es una extensión que permite al agente realizar tareas reales como:
- enviar emails
- gestionar calendario
- ejecutar comandos
- trabajar con archivos y APIs
En esta pantalla vemos el estado:
- Eligible: skills listas para usar
- Missing requirements: skills disponibles pero requieren dependencias externas
Para instalar esas dependencias, OpenClaw recomienda usar Homebrew, un gestor de paquetes similar a apt.
En sistemas Ubuntu/Debian también es posible instalar dependencias manualmente usando:
sudo apt install …
Configurar skills es un paso fundamental para que OpenClaw sea más que un chatbot y se convierta en un verdadero asistente autónomo.
Selección de Skills opcionales
Durante el onboarding, OpenClaw muestra una lista de “skills” disponibles.
Cada skill representa una integración adicional (correo, GitHub, notas, etc.) y muchas requieren instalar dependencias externas.
En esta pantalla se recomienda comenzar con:
- Skip for now, para mantener la instalación mínima y segura
- Activar skills solo después, cuando el sistema esté funcionando correctamente
Esto reduce la superficie de ataque y evita exponer credenciales o integraciones innecesarias.
Hooks: automatizaciones internas del agente
Durante el onboarding, OpenClaw ofrece habilitar hooks, que son automatizaciones que se ejecutan cuando el agente recibe ciertos comandos.
Por ejemplo, un hook puede guardar automáticamente el contexto de una sesión cuando se inicia una nueva conversación.
Algunos hooks disponibles incluyen:
- command-logger: registra comandos ejecutados
- session-memory: guarda contexto entre sesiones
- boot-md: carga instrucciones al iniciar
⚠️ Por motivos de seguridad y simplicidad, se recomienda comenzar con Skip for now y habilitar hooks únicamente después de entender su impacto, especialmente en entornos expuestos o con datos sensibles.
Lanzar el bot por primera vez (“Hatch”)
Al final del onboarding, OpenClaw pregunta cómo deseas inicializar el bot:
- Hatch in TUI (recomendado): inicia el bot directamente en la terminal
- Open in the Web UI: abre la interfaz web gráfica
- Do this later: finaliza la instalación sin arrancarlo todavía
Para la mayoría de servidores Linux, la opción recomendada es Hatch in TUI, ya que permite probar el bot inmediatamente desde SSH sin exponer una interfaz web.
Primer arranque exitoso (Bot Online)
Después de seleccionar Hatch in TUI, OpenClaw inicia su interfaz en terminal y muestra un mensaje de bienvenida:
- El agente está conectado (
connected) - Está activo y esperando instrucciones (
idle) - Se trata de una instalación limpia (“blank slate”)
En la barra inferior también se confirma el modelo LLM en uso (por ejemplo Claude Opus) y el consumo de tokens.
En este punto, el bot ya está funcionando correctamente y puedes comenzar a interactuar con él desde Telegram u otro canal conectado.
Emparejamiento inicial (Pairing) en Telegram
La primera vez que escribes al bot desde Telegram, OpenClaw puede responder:
OpenClaw: access not configured.
Esto es normal. Por seguridad, OpenClaw no permite acceso hasta que el propietario autorice explícitamente al usuario.
Telegram mostrará:
- tu user ID
- un pairing code temporal
Para aprobar el acceso, ejecuta en el servidor:
openclaw pairing approve telegram <code>
Una vez aprobado, el bot responderá normalmente en Telegram.
Este mecanismo previene que usuarios no autorizados interactúen con el agente.
🔒 Hardening de Seguridad
NO ignores esta sección. Es la diferencia entre un asistente útil y una brecha de seguridad.
Nunca expongas el Gateway a internet público
# El Gateway debe escuchar solo en localhost
# Verifica en la configuración que bind_address sea 127.0.0.1Usa un reverse proxy con autenticación
Si necesitas acceso remoto, usa Cloudflare Tunnel (tengo un tutorial aquí) o configura Nginx con autenticación básica.
Revisa los permisos del agente
En la configuración, limita qué acciones puede realizar el agente. No le des acceso total a tu sistema a menos que sea absolutamente necesario.
💰 ¿Cuánto Cuesta?
Moltbot/OpenClaw es completamente gratuito y open source (licencia MIT). Sin embargo, el costo real proviene del modelo de lenguaje (LLM) que utilices, ya que la mayoría de proveedores cobran por consumo de tokens vía API.
| Modelo | Entrada | Salida |
|---|---|---|
| Claude Sonnet | ~$3/millón tokens | ~$15/millón tokens |
| Claude Opus | Mayor costo | Mayor costo |
| GPT-4 | Variable | Variable |
Para un uso personal moderado, es razonable esperar entre $5–20 USD mensuales, dependiendo de cuánto lo uses y qué modelo elijas.
✅ OAuth: una forma de controlar costos
Una ventaja importante de OpenClaw es que no depende únicamente de claves de API pagadas por token. El proyecto también soporta autenticación mediante OAuth con proveedores como:
- OpenAI
- Anthropic (Claude)
- Gemini
Esto significa que, en algunos casos, puedes conectar tu cuenta directamente en lugar de usar una API key tradicional.
📌 En la práctica, esto permite que puedas aprovechar planes como:
- ChatGPT Plus / Pro
- Claude Pro
- Gemini Pro
y mantener costos más predecibles, especialmente para uso personal o experimental.
⚠️ Nota importante
El soporte OAuth no elimina completamente los costos en todos los escenarios, ya que ciertas funciones avanzadas o integraciones pueden seguir requiriendo acceso vía API.
Aun así, es una opción muy útil para:
- evitar facturación inesperada por tokens
- probar el agente sin configurar billing desde el inicio
- mantener un presupuesto controlado
🚀 Conclusión
Moltbot representa el futuro de los asistentes personales de IA: código abierto, autoalojado y profundamente integrado en tu vida digital. Sin embargo, con gran poder viene gran responsabilidad.
Si decides instalarlo, hazlo con precaución. Sigue las mejores prácticas de seguridad, mantén tu instancia actualizada, y nunca la expongas directamente a internet.
¿Ya probaste Moltbot? ¿Tienes dudas sobre la instalación? Déjame un comentario abajo 👇
Recursos adicionales:
