OpenClaw: Tu Asistente Personal de IA en Todos tus Dispositivos
El asistente de IA open-source de 385K estrellas que corre en tu máquina y chatea contigo donde ya estás: Telegram, WhatsApp, Discord, Slack y más.
OpenClaw es un asistente personal de IA que se ejecuta en tus propios dispositivos y te encuentra en los canales que ya usas. Diseñado para un único operador, conecta modelos, herramientas, canales de mensajería y apps complementarias a través de un único Gateway local. En este curso aprenderás a instalarlo, configurarlo, conectarlo a tus chats favoritos, extenderlo con skills y plugins, y operarlo de forma segura.
Contenido
- ¿Qué es OpenClaw y por qué es el repo más caliente?
- Arquitectura: el Gateway y sus interfaces
- Instalación en macOS, Linux y Windows
- Onboarding: tu primer chat en 5 minutos
- Modelos y proveedores: hosted y locales
- Canales: chatea desde Telegram, WhatsApp, Discord y más
- Herramientas: qué puede hacer tu asistente
- Skills: enseña a tu agente con Markdown
- Plugins y ClawHub: extiende la plataforma
- Seguridad y operación del Gateway
1. ¿Qué es OpenClaw y por qué es el repo más caliente?
OpenClaw es un asistente personal de IA que corre en tus dispositivos y se conecta a los canales de mensajería que ya usas. Su filosofía es clara: "your assistant, on your devices, in your chats". No es un chatbot más en la nube: el Gateway vive en tu máquina, tus datos se quedan contigo y tú decides qué modelos, herramientas y canales conectas.
El proyecto, creado por Peter Steinberger y una comunidad enorme, ha superado las 385.000 estrellas en GitHub en menos de un año (el repo fue creado en noviembre de 2025), con más de 81.000 forks y actividad diaria. Es la demostración de que el futuro de los asistentes es personal, local y abierto, no atado a una app propietaria.
| Característica | OpenClaw | Asistente en la nube |
|---|---|---|
| Dónde corre | En tus dispositivos (Gateway local) | En servidores del proveedor |
| Datos | Los controlas tú (own-your-data) | En manos del proveedor |
| Canales | 30+ (Telegram, WhatsApp, Discord, iMessage…) | App propia, web o API |
| Modelos | Cualquiera: hosted o local | Solo los del proveedor |
| Extensibilidad | Skills, plugins, ClawHub, SDK | Limitada a la API |
| Licencia | MIT, open source | Propietaria |
El proyecto nació para Molty, un asistente "langosta espacial" (space lobster 🦞). Ese toque de humor es parte de la cultura del repo: la comunidad se llama a sí misma "clawtributors".
2. Arquitectura: el Gateway y sus interfaces
Para entender OpenClaw hay que conocer su pieza central: el Gateway. Es el plano de control local que orquesta sesiones, herramientas, eventos y conexiones de canales. Todo pasa por él: los mensajes entrantes, las llamadas a herramientas, la configuración de modelos y el estado de cada canal.
Al Gateway se conectan varias interfaces, y todas hablan con el mismo asistente:
| Interfaz | Qué es | Cómo se abre |
|---|---|---|
| Control UI | Dashboard web para chatear y administrar | openclaw dashboard |
| CLI | Comandos para instalar, configurar y operar | openclaw |
| TUI | Interfaz de terminal interactiva | openclaw tui |
| Channels | Conexiones a apps de mensajería | openclaw channels add |
| Nodos / companion apps | Voz, Canvas, cámara, pantalla y acciones locales | Apps complementarias por plataforma |
El Gateway escucha por defecto en el puerto 18789 de tu máquina. Los canales pueden ejecutarse simultáneamente: OpenClaw enruta cada conversación según el chat de origen, así puedes hablar con el mismo asistente desde Telegram y desde la Control UI sin perder el contexto.
3. Instalación en macOS, Linux y Windows
El instalador oficial soporta macOS, Linux y Windows, y aprovisiona Node.js automáticamente si hace falta. Los requisitos de Node son: 22.22.3+, 24.15+ o 25.9+ (Node 26 es el runtime recomendado).
macOS / Linux / WSL2
Un solo comando descarga y ejecuta el instalador oficial:
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
Para Windows nativo, usa el instalador de PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iexCon npm (ya gestionas Node)
Si ya tienes Node en la versión correcta, instala el paquete publicado globalmente:
npm install -g openclaw@latestVerifica
Comprueba que el binario quedó instalado:
openclaw --versionExisten rutas alternativas de despliegue: Docker y Nix. La documentación oficial cubre los requisitos de scripts de ciclo de vida de npm 12 para instalaciones más avanzadas.
4. Onboarding: tu primer chat en 5 minutos
El onboarding verifica el acceso a los modelos, crea el workspace y configura el Gateway. Es el camino más rápido de cero a un asistente funcionando:
Ejecuta el onboarding
El asistente --install-daemon instala el daemon para que el Gateway arranque solo:
openclaw onboard --install-daemonEl asistente te guía para elegir un proveedor de modelos (Anthropic, OpenAI, Google, etc.) e introducir tu API key. Si te saltas pasos opcionales, puedes volver con openclaw configure.
Verifica el Gateway
Deberías ver el Gateway escuchando en el puerto 18789:
openclaw gateway statusAbre el dashboard
Esto lanza la Control UI en tu navegador. Si carga, todo está funcionando:
openclaw dashboardEnvía tu primer mensaje
Escribe un mensaje en el chat de la Control UI y deberías recibir una respuesta de IA.
¿Quieres chatear desde el móvil? El canal más rápido de configurar es Telegram: solo necesitas un bot token. Lo verás en la lección 6.
Si el Gateway no arranca, revisa primero la versión de Node (node --version). Los instaladores provisionan Node, pero si instalaste con npm directamente y tu versión es antigua, el daemon fallará silenciosamente.
5. Modelos y proveedores: hosted y locales
OpenClaw funciona con proveedores hosted y locales. Puedes usar los modelos de Anthropic, OpenAI, Google y otros, o conectar modelos que corren en tu propia máquina (Ollama, llama.cpp, etc.) — la elección es tuya y puedes cambiarla en cualquier momento con openclaw configure.
El onboarding crea perfiles de autenticación (auth profiles) que guardan tus credenciales de forma canónica. OpenClaw tiene reglas claras de elegibilidad y resolución de credenciales, lo que evita sorpresas cuando un canal o una herramienta necesita llamar a un modelo.
| Tipo | Ejemplos | Ventaja | Consideración |
|---|---|---|---|
| Hosted | Anthropic Claude, OpenAI, Google Gemini | Máxima calidad, cero setup local | Requiere API key y consume crédito |
| Local | Ollama, llama.cpp, servidores propios | Privacidad total, sin coste por token | Necesita hardware suficiente |
Empieza con un modelo hosted para el onboarding (es lo más rápido) y prueba un modelo local después. Puedes tener ambos configurados y alternar por sesión o por tarea.
6. Canales: chatea desde Telegram, WhatsApp, Discord y más
La magia de OpenClaw es que te encuentras con tu asistente en las apps que ya usas. Soporta más de 30 canales: Telegram, WhatsApp, Discord, Slack, Signal, iMessage, Google Chat, Matrix, Microsoft Teams, Zalo, IRC, Twitch y muchos más.
El canal de Telegram viene incluido en el paquete core (bundled plugin) y es el más rápido de montar: creas un bot con BotFather y pegas el token. Los canales "official plugin" se instalan con un comando y requieren reiniciar el Gateway:
openclaw plugins install @openclaw/<canal-id>
openclaw gateway restart| Canal | Tipo | Notas |
|---|---|---|
| Telegram | Bundled plugin | El más fácil: solo bot token |
| WebChat | Incluido en core | Chat en la Control UI vía WebSocket |
| Official plugin | Se instala bajo demanda al activar el canal | |
| Discord / Slack / Signal / iMessage | Official plugin | Setup por bot o número, según plataforma |
| Zalo / WeChat / Yuanbao | External plugin | Mantenidos por la comunidad |
Los canales funcionan a la vez y OpenClaw enruta por chat. Además incluye protecciones como el bot loop protection para evitar que dos bots se respondan indefinidamente.
Después de instalar un canal nuevo, olvidar reiniciar el Gateway es el fallo número uno. El comando openclaw gateway restart es tu mejor amigo tras cualquier cambio de plugins o configuración.
7. Herramientas: qué puede hacer tu asistente
Las herramientas (tools) son las acciones que el asistente puede ejecutar. OpenClaw viene con herramientas listas para usar: Browser (navegar y leer webs), exec (ejecutar comandos en el host), web search (búsqueda en internet), además de skills, plugins y la herramienta message para que el asistente envíe mensajes proactivos.
Un detalle importante de seguridad: las herramientas se ejecutan en el host para la sesión principal salvo que configures sandboxing. Esto le da un poder enorme al asistente (puede ejecutar comandos reales), y por eso la lección 10 es obligatoria antes de exponerlo a más usuarios.
| Herramienta | Qué hace | Ejemplo de uso |
|---|---|---|
| Browser | Navega y extrae contenido de webs | "Resume la página de docs de OpenClaw" |
| exec | Ejecuta comandos en tu máquina | "Muéstrame los 5 procesos que más CPU usan" |
| web search | Busca en internet | "Busca novedades de OpenClaw esta semana" |
| message | Envía mensajes proactivos a tus canales | "Avísame cuando el build termine" |
| Skills | Instrucciones para usar otras herramientas | Ver lección 8 |
| Plugins | Capacidades empaquetadas | Ver lección 9 |
8. Skills: enseña a tu agente con Markdown
Las skills son archivos de instrucciones en Markdown que enseñan al agente cómo y cuándo usar las herramientas. Cada skill vive en un directorio con un archivo SKILL.md que tiene frontmatter YAML y un cuerpo en Markdown.
---
name: resumen-docs
description: Resume páginas de documentación técnica en español
---
# Resumen de documentación
Cuando el usuario pida resumir una doc:
1. Usa la herramienta Browser para abrir la URL.
2. Extrae los títulos de sección (h2, h3).
3. Resume cada sección en 2-3 líneas en español.
4. Cita la fuente al final.OpenClaw carga las skills desde varias fuentes con precedencia estricta (de mayor a menor prioridad):
| Prioridad | Fuente | Ruta |
|---|---|---|
| 1 (máxima) | Workspace skills | <workspace>/skills |
| 2 | Project agent skills | <workspace>/.agents/skills |
| 3 | Personal agent skills | ~/.agents/skills |
| 4 | Managed / local skills | <state-dir>/skills |
| 5 | Bundled skills | Incluidas con la instalación |
| 6 (mínima) | Extra directories | skills.load.extraDirs + plugins |
Puedes organizar las skills en carpetas (hasta 6 niveles de profundidad): OpenClaw descubre cualquier SKILL.md bajo una raíz configurada. El nombre y el comando slash de la skill vienen del campo name del frontmatter.
El Skill Workshop permite revisar y aprobar propuestas de skills redactadas por el propio agente, y ClawHub es el marketplace de skills de la comunidad.
9. Plugins y ClawHub: extiende la plataforma
Los plugins empaquetan capacidades completas: canales oficiales (Discord, WhatsApp, Signal…), voz, integraciones y más. Se gestionan desde el CLI:
# Ver plugins instalados
openclaw plugins list
# Instalar un plugin oficial (por ejemplo, el canal de Discord)
openclaw plugins install @openclaw/discord
# Reiniciar para cargar el plugin
openclaw gateway restartClawHub es el hub de la comunidad donde se comparten skills y plugins. Si tienes una idea nueva, lo normal es construirla como plugin sobre el plugin SDK y publicarla ahí. El propio README del repo lo dice: "New capabilities usually belong in plugins built on the plugin SDK and shared through ClawHub."
También hay plugins externos mantenidos fuera del repo oficial (por ejemplo, el canal de WeChat o Yuanbao). Todos siguen el mismo mecanismo de instalación y carga.
El proyecto se desarrolla en abierto bajo la OpenClaw Foundation, una entidad sin ánimo de lucro. Las PRs asistidas por IA son bienvenidas — la comunidad lo fomenta explícitamente.
10. Seguridad y operación del Gateway
OpenClaw trata los mensajes entrantes como datos no confiables. Esa es la regla de oro. Los canales con DM (mensajes directos) emparejan a remitentes desconocidos por defecto: para aprobar a una persona, usas el comando de pairing:
openclaw pairing approve <canal> <código>Antes de conectar a otros usuarios o exponer el Gateway remotamente, lee la guía de seguridad y el runbook de exposición. Las opciones clave:
- Pairing: controla quién puede escribirle a tu agente. Aprobación explícita por canal y código.
- Sandboxing: las herramientas corren en el host por defecto; configura sandboxes para aislarlas cuando haga falta.
- Bot loop protection: evita que dos bots se respondan en bucle infinito.
- Exposición: si abres el Gateway a la red, sigue el exposure runbook al pie de la letra.
La operación diaria es sencilla. Para reiniciar o actualizar:
# Reiniciar el Gateway tras cambios
openclaw gateway restart
# Estado del Gateway
openclaw gateway status
# Actualizar a la última versión
npm update -g openclawOpenClaw ofrece release channels (canales de lanzamiento) para elegir entre versiones estables y de desarrollo, y la actualización conserva tu workspace y configuración.
El error de seguridad más típico: aprobar pairing de desconocidos "solo para probar" o ejecutar el Gateway sin sandboxing con acceso a la red pública. Un agente con exec y sin sandbox equivale a darle una terminal a cualquiera que pueda escribirle.
Preguntas frecuentes
¿OpenClaw es gratuito?
El software es open source con licencia MIT, así que es gratis. Eso sí, necesitas acceso a un proveedor de modelos: una API key de un servicio hosted (Anthropic, OpenAI, Google…) o tus propios modelos locales.
¿Necesito saber programar?
Para el uso básico no: el instalador y el onboarding guiado te llevan a un chat funcionando en minutos. Programar te sirve para crear skills y plugins avanzados, pero no es requisito para empezar.
¿Puedo usar modelos locales en vez de la nube?
Sí. OpenClaw funciona con proveedores hosted y locales. Puedes configurar ambos y alternar. Los modelos locales dan máxima privacidad, a cambio de requerir hardware suficiente.
¿Qué canales de mensajería soporta?
Más de 30: Telegram, WhatsApp, Discord, Slack, Signal, iMessage, Google Chat, Matrix, Microsoft Teams, Zalo, IRC, Twitch y otros. Telegram es el más rápido de configurar (solo un bot token).
¿Cómo sé que mis datos están seguros?
El Gateway corre en tu máquina y los datos se quedan contigo. Usa el pairing para controlar quién escribe, configura sandboxing para las herramientas y no expongas el Gateway a la red sin seguir el runbook de seguridad.