OpenClaw Guide: Build Your AI Assistant
Tutorial paso a paso para instalar, configurar y usar OpenClaw (anteriormente Moltbot/Clawdbot), el asistente de IA de código abierto viral con más de 135K estrellas en GitHub. Conéctalo a WhatsApp, Telegram, Discord y automatiza tu vida.
TL;DR
- OpenClaw es un asistente de IA de código abierto con más de 135K estrellas en GitHub
- Se ejecuta localmente en tu máquina; tus datos permanecen privados
- Conéctalo a través de WhatsApp, Telegram, Discord, Slack, iMessage y más
- Más de 3,000 habilidades de la comunidad para automatización, programación, hogar inteligente y más
- Gratis (solo pagas por los tokens de la API de IA, típicamente entre $10 y $50 al mes)
- La configuración toma ~30 minutos con esta guía
¿Qué es OpenClaw?
OpenClaw (anteriormente conocido como Clawdbot, luego Moltbot) es el proyecto de IA de código abierto más popular de 2026. Es un asistente de IA personal que:
- Se ejecuta en tu propia computadora o servidor
- Se conecta a tus aplicaciones de mensajería favoritas (WhatsApp, Telegram, Discord, etc.)
- Tiene acceso completo a tu sistema de archivos, terminal y navegador
- Puede automatizar tareas como un asistente personal potenciado
La evolución: Clawdbot → Moltbot → OpenClaw
El proyecto ha tenido toda una aventura con sus nombres:
| Fecha | Nombre | Razón |
|---|---|---|
| Nov 2025 | Clawdbot | Nombre original del creador Peter Steinberger |
| Dic 2025 | Moltbot | Renombrado tras una solicitud de marca registrada de Anthropic |
| Ene 2026 | OpenClaw | Cambio de marca de la comunidad por independencia |
No importa cómo lo llames, la funcionalidad sigue siendo la misma: un asistente de IA increíblemente potente que se ejecuta localmente.
¿Por qué elegir OpenClaw?
vs. ChatGPT / Claude Web
| Característica | ChatGPT/Claude | OpenClaw |
|---|---|---|
| Se ejecuta localmente | ❌ | ✅ |
| Acceso a tus archivos | ❌ | ✅ |
| Ejecuta comandos de terminal | ❌ | ✅ |
| Controla tu computadora | ❌ | ✅ |
| Funciona en WhatsApp | ❌ | ✅ |
| Privacidad de datos | Basado en la nube | 100% local |
| Extensible con habilidades | Limitado | Más de 3,000 habilidades |
vs. Otros agentes de IA
Las características estrella de OpenClaw:
- Bandeja de entrada multicanal: Una sola IA, accesible desde WhatsApp, Telegram, Discord, Slack, iMessage y más de 12 plataformas.
- Memoria persistente: Recuerda el contexto a través de las conversaciones.
- Ecosistema de habilidades: Más de 3,000 complementos de la comunidad a través de ClawHub.
- Agnóstico al modelo: Funciona con Claude, GPT, Gemini, DeepSeek, modelos locales de Ollama, etc.
- Código abierto: Licencia MIT, código totalmente auditable.
Requisitos previos
Antes de comenzar, asegúrate de tener:
- [ ] Una computadora (Mac, Windows con WSL2 o Linux)
- [ ] Node.js v22+ instalado (descárgalo aquí)
- [ ] Una clave de API de IA (Anthropic Claude, OpenAI u otros)
- [ ] ~30 minutos de tiempo
Requisitos de hardware
| Configuración | RAM | Almacenamiento | Notas |
|---|---|---|---|
| Mínimo | 4GB | 1GB | Funcionalidad básica |
| Recomendado | 8GB+ | 2GB+ | Experiencia fluida |
| Con modelos locales | 16GB+ | 50GB+ | Para ejecutar Ollama |
Métodos de instalación
Método 1: Instalación en una sola línea (Recomendado)
La forma más rápida de empezar:
curl -fsSL https://openclaw.bot/install.sh | bash
Este script:
- Verificará los requisitos de tu sistema
- Instalará OpenClaw
- Iniciará el asistente de configuración (onboarding)
Método 2: Docker (Recomendado para servidores)
Si prefieres un despliegue basado en contenedores:
# Clonar el repositorio
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Ejecutar la configuración de Docker
./docker-setup.sh
La configuración de Docker crea dos directorios importantes:
~/.openclaw/— Configuración, memoria, claves de API~/openclaw/workspace/— Archivos accesibles para el agente de IA
Método 3: Construir desde el código fuente
Para desarrolladores que desean un control total:
# Clonar el repositorio
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# Instalar dependencias
pnpm install
# Construir la interfaz de usuario
pnpm ui:build
# Construir el proyecto
pnpm build
# Ejecutar el onboarding
pnpm openclaw onboard --install-daemon
Configuración paso a paso
Paso 1: Ejecutar el asistente de configuración
Después de la instalación, el asistente de configuración se inicia automáticamente. Si no es así, ejecuta:
openclaw onboard --install-daemon
El asistente te guiará a través de:
- Selección del proveedor del modelo
- Configuración de la clave API
- Configuración de la plataforma de mensajería
- Ajustes de seguridad
Paso 2: Configurar tu modelo de IA
OpenClaw admite múltiples proveedores de IA. Elige uno:
Opción A: Anthropic Claude (Recomendado)
# Establece tu clave API
export ANTHROPIC_API_KEY=sk-ant-xxxxx
# O usa el comando de configuración
openclaw config set 'models.default' 'claude-sonnet-4'
Opción B: OpenAI
export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'
Opción C: DeepSeek (Económico)
openclaw config set 'models.providers.deepseek' --json '{
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "your-api-key",
"api": "openai-completions",
"models": [
{ "id": "deepseek-chat", "name": "DeepSeek Chat" },
{ "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
]
}'
Opción D: Modelos locales con Ollama
Para una privacidad total, ejecuta modelos localmente:
# Instala Ollama primero: https://ollama.ai
ollama pull llama3.3
# Configura OpenClaw para usarlo
openclaw config set 'models.providers.ollama' --json '{
"baseUrl": "http://localhost:11434/v1",
"api": "openai-completions",
"models": [
{ "id": "llama3.3", "name": "Llama 3.3" }
]
}'
Paso 3: Conectar plataformas de mensajería
Aquí es donde OpenClaw brilla: chatea con tu IA desde cualquier lugar.
Telegram (El más sencillo)
- Envía un mensaje a @BotFather en Telegram
- Envía
/newboty sigue las instrucciones - Copia el token de tu bot
- Configura OpenClaw:
openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'
OpenClaw utiliza WhatsApp Web para la conexión:
# Habilitar canal de WhatsApp
openclaw config set 'channels.whatsapp.enabled' true
# Reiniciar el gateway
openclaw gateway restart
# Escanear el código QR que aparece
Aparecerá un código QR en tu terminal. Escanéalo con WhatsApp en tu teléfono (Ajustes → Dispositivos vinculados → Vincular un dispositivo).
Discord
- Crea una aplicación de Discord en discord.com/developers
- Crea un bot y copia el token
- Configura:
openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'
iMessage (Solo Mac)
Para usuarios de Mac, OpenClaw puede conectarse directamente a iMessage:
openclaw config set 'channels.imessage.enabled' true
Paso 4: Iniciar el Gateway
El gateway es el servicio en segundo plano que mantiene a OpenClaw en funcionamiento:
# Iniciar como un demonio (servicio en segundo plano)
openclaw gateway start
# O ejecutar en primer plano para depuración
openclaw gateway
# Verificar estado
openclaw gateway status
# Ver registros (logs)
openclaw logs --follow
Paso 5: Acceder al Dashboard web
OpenClaw incluye una interfaz web para configuración y chat directo:
# Abrir el dashboard en tu navegador
openclaw dashboard
Esto abrirá http://127.0.0.1:18789/ con un token de inicio de sesión temporal.
Desde el dashboard puedes:
- Chatear directamente con tu IA
- Administrar ajustes
- Ver el historial de conversaciones
- Instalar habilidades
Tu primera conversación
Una vez que todo esté configurado, envía un mensaje a tu bot (vía Telegram, WhatsApp o la interfaz web):
¡Hola! ¿Puedes decirme qué puedes hacer?
OpenClaw se presentará y mostrará sus capacidades. Prueba algunas tareas reales:
¿Qué archivos hay en mi carpeta de Descargas?
Busca en mis documentos cualquier cosa relacionada con "impuestos 2025"
Crea un script de Python que convierta CSV a JSON
¿Qué es lo que más espacio en disco está usando en mi computadora?
Instalación de habilidades (Skills)
Las habilidades amplían las capacidades de OpenClaw. Explora el registro de ClawHub o instálalas directamente:
Habilidades populares
# Integración con GitHub
openclaw skill install github
# Automatización del navegador web
openclaw skill install agent-browser
# Gestión de calendario
openclaw skill install calendar
# Automatización de correo electrónico
openclaw skill install email
# Control del hogar inteligente
openclaw skill install homeassistant
# Generación de imágenes
openclaw skill install dalle
# Conversaciones de voz (Discord)
openclaw skill install discord-voice
Categorías de habilidades
| Categoría | Habilidades populares | Casos de uso |
|---|---|---|
| Desarrollador | github, gitlab, jira, linear | Revisiones de PR, gestión de incidencias |
| Productividad | calendar, email, notion, todoist | Programación, gestión de tareas |
| Automatización | agent-browser, puppeteer, selenium | Web scraping, llenado de formularios |
| Hogar Inteligente | homeassistant, philips-hue, tuya | Control de luces, escenas |
| Finanzas | crypto-prices, stock-tracker | Monitoreo de portafolios |
| Multimedia | spotify, youtube-dl, plex | Control de música, descargas |
Advertencia de seguridad
⚠️ Importante: Revisa las habilidades antes de instalarlas. La naturaleza abierta de ClawHub significa que pueden existir habilidades maliciosas. Usa openclaw skill inspect para revisar el código, o pide a Claude Code / Codex que lo audite por ti.
Configuración avanzada
Estructura del archivo de configuración
OpenClaw almacena la configuración en ~/.openclaw/:
~/.openclaw/
├── openclaw.json # Configuración principal
├── env # Variables de entorno (claves API)
├── memory/ # Almacenamiento de memoria persistente
├── skills/ # Habilidades instaladas
├── backups/ # Copias de seguridad de la configuración
└── logs/ # Archivos de registro
Editar la configuración
# Ver configuración actual
openclaw config get
# Establecer un valor
openclaw config set 'key.path' 'value'
# Editar en tu editor por defecto
openclaw config edit
Gestión de la memoria
OpenClaw mantiene una memoria persistente a través de las conversaciones:
# Ver estadísticas de memoria
openclaw memory stats
# Borrar toda la memoria (¡con cuidado!)
openclaw memory clear
# Exportar memoria para copia de seguridad
openclaw memory export > memory-backup.json
Ejecutar comprobaciones de estado
# Comprobación de estado exhaustiva
openclaw doctor
# Comprobar componentes específicos
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills
Mejores prácticas de seguridad
OpenClaw tiene acceso total al sistema; eso es lo que lo hace potente, pero también riesgoso. Sigue estas pautas:
1. Usa una máquina dedicada
No ejecutes OpenClaw en tu computadora de trabajo principal. Opciones:
- VPS: DigitalOcean, Vultr, AWS ($5-20/mes)
- Laptop vieja: Reutiliza hardware antiguo
- Raspberry Pi: Funciona para uso ligero
- Docker: Proporciona cierto aislamiento
2. Habilita el modo Sandbox
Para sesiones no confiables (chats grupales, canales):
openclaw config set 'agents.defaults.sandbox.mode' 'non-main'
Esto ejecuta las sesiones de grupos/canales dentro de sandboxes de Docker.
3. Usa listas de permitidos (Allowlists)
Permite que solo usuarios específicos interactúen con tu bot:
# Telegram
openclaw config set 'channels.telegram.allowlist' '["username1", "username2"]'
# Discord
openclaw config set 'channels.discord.allowlist' '["user_id_1", "user_id_2"]'
4. Mantente actualizado
Se han encontrado vulnerabilidades de seguridad en versiones anteriores. Ejecuta siempre la última:
# Buscar actualizaciones
openclaw update --check
# Actualizar a la última versión
openclaw update
Nota: Las versiones anteriores a la 2026.1.29 tienen una vulnerabilidad de seguridad conocida. Actualiza inmediatamente si estás en una versión antigua.
5. Audita las habilidades antes de instalarlas
# Inspeccionar el código de una habilidad
openclaw skill inspect <skill-name>
# Consultar la reputación de una habilidad
openclaw skill info <skill-name>
Ejemplos de automatización
Aquí es donde OpenClaw se vuelve realmente potente:
Resumen matutino
Configura un resumen diario a las 8 AM:
# En tu configuración, añade una tarea cron
openclaw config set 'automations.morning-briefing' --json '{
"cron": "0 8 * * *",
"action": "Envíame un resumen de: pronóstico del tiempo, eventos del calendario de hoy, correos electrónicos importantes no leídos y los 3 titulares de noticias principales"
}'
Bot de revisión de PR en GitHub
Revisa automáticamente los PR cuando te los asignen:
openclaw skill install github
# Configurar webhook o sondeo (polling)
openclaw config set 'automations.pr-review' --json '{
"trigger": "github.pr.assigned",
"action": "Revisa el PR, busca errores, problemas de seguridad y violaciones de estilo. Publica un comentario de resumen."
}'
Escenas de hogar inteligente
openclaw skill install homeassistant
# Automatización "Saliendo de casa"
openclaw config set 'automations.leaving-home' --json '{
"trigger": "location.leave_home",
"action": "Apaga todas las luces, pon el termostato en modo eco, arma el sistema de seguridad"
}'
Organización de archivos
Dile a OpenClaw que organice tu carpeta de Descargas:
Organiza mi carpeta de Descargas: mueve las imágenes a ~/Pictures, los documentos a ~/Documents y elimina cualquier cosa que tenga más de 30 días
Solución de problemas
Problemas comunes
"Command not found: openclaw"# Añadir al PATH
export PATH="$HOME/.openclaw/bin:$PATH"
# Añadir a tu perfil de shell (.bashrc, .zshrc)
# Verifica tus variables de entorno
openclaw config get models
# Vuelve a ejecutar el onboarding
openclaw onboard
# Revisar logs
openclaw logs --channel whatsapp
# Reiniciar el gateway
openclaw gateway restart
# Reconstruir el índice de habilidades
openclaw skill rebuild
# Buscar conflictos
openclaw doctor --check skills
Obtener ayuda
- Documentación: docs.openclaw.ai
- GitHub Issues: github.com/openclaw/openclaw/issues
- Comunidad de Discord: discord.gg/openclaw
- Reddit: r/OpenClaw
Desglose de costos
OpenClaw en sí es gratuito. Tus costos provienen del uso de la API de IA:
| Nivel de uso | Tokens mensuales | Costo estimado |
|---|---|---|
| Ligero | ~1M tokens | $3-10 |
| Moderado | ~5M tokens | $15-40 |
| Pesado | ~20M tokens | $60-150 |
| Usuario avanzado | 50M+ tokens | $150+ |
Consejos para ahorrar costos
- Usa DeepSeek para tareas rutinarias ($0.14/M tokens vs los $3/M de Claude)
- Modelos locales para consultas simples (gratis tras el hardware)
- Establece límites de tokens por conversación
- Usa caché para consultas repetidas
¿Qué sigue?
Ahora que tienes OpenClaw funcionando, aquí tienes algunas ideas:
Construye tus propias habilidades
Crea habilidades personalizadas para tus necesidades específicas:
# Crear una nueva habilidad
openclaw skill create my-custom-skill
# Editar la habilidad
code ~/.openclaw/skills/my-custom-skill/SKILL.md
Conecta más plataformas
- Añade múltiples cuentas de WhatsApp (personal + trabajo)
- Conecta Slack para el trabajo, Discord para lo personal
- Configura iMessage para el ecosistema Apple
Explora el ecosistema
- Navega por ClawHub para encontrar más de 3,000 habilidades
- Únete a la comunidad de Discord para consejos y trucos
- Sigue a @OpenClaw para actualizaciones
Yendo más allá: Despliega tus propios productos de IA
Una vez que hayas experimentado el poder de los asistentes de IA, es posible que quieras crear productos para otros. Ahí es donde entra Y Build.
Y Build te ayuda a pasar de una idea impulsada por IA a un producto lanzado:
- Programación con IA: Describe lo que quieres, la IA genera el código
- Despliegue con un clic: Sal al aire instantáneamente con un CDN global
- Herramientas de crecimiento: Videos de demostración, optimización SEO, analíticas
- Una herramienta SaaS impulsada por IA
- Una plataforma de automatización como OpenClaw
- Un chatbot personalizado para tu negocio
Conclusión
OpenClaw representa un nuevo paradigma en la IA personal: un asistente que es:
- Local: Tus datos nunca salen de tu máquina
- Potente: El acceso total al sistema significa automatización real
- Extensible: Más de 3,000 habilidades y creciendo
- Multiplataforma: Una sola IA, accesible en todas partes
- Responder preguntas desde tu WhatsApp
- Buscar y organizar tus archivos
- Automatizar tareas repetitivas
- Controlar tu hogar inteligente
- Y mucho más
Bienvenido a la comunidad de OpenClaw. 🦞
Fuentes: