OpenClaw: qué es, cómo instalarlo y conectarlo a Telegram

OpenClaw apareció en mi feed el invierno pasado, cuando el proyecto cambió de nombre dos veces en una semana y consiguió cientos de miles de estrellas en GitHub. Desde entonces, cada vez más gente busca «openclaw installation» y «openclaw telegram».

A continuación, repaso la documentación oficial: qué es esta herramienta, en qué se diferencia de Claude Code, cómo instalarla en Windows, macOS o Linux, elegir un modelo y conectar un bot de Telegram. También trato la seguridad por separado, porque OpenClaw se ha visto implicado en un par de incidentes muy sonados.

Descubre cómo trabajar con el servicio en la documentación de Ailoot.

¿Qué agente de inteligencia artificial es OpenClaw?#

OpenClaw conecta un modelo de IA a tu bot de Telegram. Con los permisos y herramientas pertinentes configurados, puede resumir mensajes o programar un recordatorio. La pasarela y su configuración local se ejecutan en tu ordenador o servidor. Eso no hace locales todas las conversaciones: al seleccionar un modelo en la nube, la solicitud y el contexto pertinente se envían a ese proveedor. Si conectas mediante Ailoot, la solicitud pasa por Ailoot al proveedor del modelo elegido. La inferencia local requiere un modelo local sin alternativa automática en la nube; los mensajes de Telegram siguen pasando por Telegram y las herramientas habilitadas pueden contactar con otros servicios.

El proyecto lo desarrolla la comunidad de código abierto de OpenClaw. El repositorio de GitHub se creó el 24 de noviembre de 2025 y, a 22 de agosto de 2026, tiene 387 mil estrellas y 81 mil forks: uno de los proyectos abiertos de más rápido crecimiento del año. El lenguaje es TypeScript.

El proyecto tiene una historia curiosa de nombres que conviene conocer para que los artículos antiguos no te confundan. Empezó como Warelay, una pasarela para WhatsApp. Después fue Clawdbot. En enero de 2026, Anthropic pidió un cambio de nombre por motivos de marca, y el proyecto pasó un par de días llamándose Moltbot. El 30 de enero de 2026 recibió su nombre definitivo: OpenClaw. Así que, si encuentras instrucciones sobre «Clawdbot» o «Moltbot», se trata del mismo proyecto; esos artículos simplemente se escribieron antes del cambio de nombre.

La mascota del proyecto es Molty, la langosta, y la «muda» (el cambio de caparazón) se convirtió en la metáfora oficial de cada cambio de nombre.

¿En qué se diferencia OpenClaw de Claude Code y Hermes Agent?#

Me preguntan constantemente por esta diferencia porque, desde fuera, todos parecen «agentes de IA». Aquí tienes una tabla comparativa:

Cómo leerla. Uso Claude Code para desarrollo: es especialmente potente cuando necesitas un modelo avanzado y trabajas con código. OpenClaw y Hermes sirven para otra cosa: un agente que funciona todo el tiempo, está en Telegram, recuerda la conversación de ayer y realiza tareas según un horario. La elección entre OpenClaw y Hermes es más sutil; ya hay una guía de Hermes con instrucciones de instalación y configuración.

Si solo estás eligiendo una herramienta, empieza por el resumen: con qué programa la gente en 2026 y qué tareas delegar a un agente de IA. También tengo un artículo aparte sobre cómo instalar Claude Code.

¿Qué necesitas antes de instalar OpenClaw?#

Comprueba tu versión de Node con antelación: es el único requisito estricto:

node --version

Se admiten las versiones 22.22.3+, 24.15+ y 25.9+; se recomienda Node 26. Si el comando devuelve «command not found» o la versión es antigua, no te preocupes: el instalador oficial descargará una versión reciente de Node por ti, así que no necesitas instalar nada manualmente.

La cuestión que queda es el modelo. OpenClaw no piensa por sí mismo: llama al modelo que elijas. Estas son las opciones de coste: una clave de Anthropic, OpenAI o Google; pagas al proveedor por el uso real. O un modelo local mediante Ollama: es gratis en términos de dinero, pero exige bastante hardware. Más abajo explico ambas opciones en secciones separadas.

¿Cómo se instala OpenClaw en macOS y Linux?#

La opción recomendada es el instalador oficial:

1. Ejecuta el instalador

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   El script detecta tu sistema operativo, comprueba si tienes Node (y lo instala si hace falta), instala OpenClaw y luego abre el asistente de configuración. Si quieres echar un vistazo antes de ejecutar el asistente, añade la opción: bash -s -- --no-onboard.

2. Comprueba que todo se haya instalado

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   El primer comando muestra la versión, el segundo comprueba la configuración y el tercero confirma que la pasarela está en marcha y escucha en el puerto 18789.

Si usas npm y quieres gestionar la instalación por tu cuenta:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Aquí hay un inconveniente reciente que se explica en un capítulo aparte de la documentación. npm 12 bloquea por defecto los scripts de instalación de paquetes y, sin la opción --allow-scripts=openclaw, la instalación se interrumpirá con un mensaje allowScripts. En npm 11.15 y versiones anteriores, la opción no hace falta: todavía no existe esa restricción. Comprueba tu versión con: npm --version.

La opción --install-daemon del segundo comando configura el inicio automático: un LaunchAgent en macOS y un servicio systemd en Linux. Así, la pasarela se inicia tras reiniciar o iniciar sesión, según las condiciones del gestor de servicios. No impide la suspensión ni mantiene la pasarela con el equipo apagado. Responder en Telegram requiere que el host siga despierto y conectado; utiliza un servidor siempre encendido si necesitas respuestas mientras el portátil duerme o está apagado.

¿Cómo se instala OpenClaw en Windows?#

La primera opción es para quienes prefieren Windows al terminal. Windows Hub es una aplicación nativa de OpenClaw para Windows 10 (20H2+) y Windows 11, actualmente en fase beta. Ve a la página de versiones de Windows Hub y descarga el instalador para tu procesador: OpenClawCompanion-Setup-x64.exe para ordenadores normales o arm64 para ARM. Tras la instalación, OpenClaw Companion aparecerá en el menú Inicio, con un icono en la bandeja del sistema, una ventana de chat y ajustes.

En el primer inicio, la aplicación ofrecerá «Set up locally»: acéptalo. Creará un entorno WSL dedicado llamado OpenClawGateway, instalará la pasarela dentro y se conectará a ella. No tocará tu instalación de Ubuntu existente, si tienes una.

La segunda opción es usar PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

La primera línea instala OpenClaw; la segunda configura el inicio automático mediante el Programador de tareas de Windows. Si la política de tu ordenador bloquea la creación de tareas, OpenClaw cambiará automáticamente a una alternativa: un acceso directo en la carpeta de Inicio para que la pasarela se inicie al iniciar sesión.

La tercera opción es WSL2, que la documentación considera el entorno de ejecución más compatible en Windows. Instala Ubuntu, activa systemd y sigue las instrucciones para Linux de la sección anterior:

wsl --install -d Ubuntu-24.04

Dentro de WSL, activa systemd en /etc/wsl.conf (la sección [boot], la línea systemd=true), reinicia WSL ejecutando wsl --shutdown desde PowerShell y luego instala OpenClaw con el comando de Linux. Si «distribución» y «systemd» no te dicen nada, usa Windows Hub; hace todo esto por ti.

¿Cómo elegir un modelo y completar la configuración inicial?#

El modelo es el motor del asistente. El asistente de configuración te ofrecerá una lista de proveedores; estas son tres opciones prácticas:

Hay un detalle interesante sobre Anthropic: si Claude Code ya está instalado en tu equipo y has iniciado sesión, OpenClaw puede usar esa sesión. Primero, ejecuta claude auth login en el equipo y luego dile a OpenClaw que la use:

openclaw models auth login --provider anthropic --method cli --set-default

Si la pasarela funciona como un servicio en segundo plano (como ocurre con --install-daemon), la clave debe estar disponible para el servicio. Para ello, colócala en ~/.openclaw/.env: el asistente lo hace por ti, así que no necesitas editar el archivo manualmente. Después de cualquier cambio, reinicia y comprueba:

openclaw gateway restart
openclaw models status

Si pagar te resulta complicado, un modelo local de la sección de Ollama es una buena opción.

¿Cómo conectar OpenClaw a Telegram?#

Telegram es el canal más rápido de conectar: solo necesitas un token de bot, sin verificación de una cuenta empresarial. La documentación lo describe como la manera más sencilla de empezar a enviar mensajes a tu asistente desde el teléfono. Este es el proceso completo:

1. Crea un bot con BotFather

   Abre un chat de Telegram con @BotFather (asegúrate de que sea exactamente ese nombre de usuario; hay muchos falsos), envía /newbot y elige un nombre y un nombre de usuario que termine en bot. Recibirás un token como 123456789:ABCdef...; es la clave de tu bot, así que guárdalo como si fuera una contraseña.

2. Introduce el token en OpenClaw

   Lo más fácil es hacerlo mediante el asistente: ejecuta openclaw configure y selecciona el canal de Telegram. La alternativa manual es el ajuste channels.telegram.botToken o la variable de entorno TELEGRAM_BOT_TOKEN. La documentación especifica que el comando openclaw channels login telegram no existe; Telegram se conecta únicamente mediante un token.

3. Inicia la pasarela y escribe al bot

   openclaw gateway
   

   Abre tu bot en Telegram y envíale un mensaje. Te responderá con un código de emparejamiento de ocho caracteres. Es una medida de protección: los mensajes no se procesarán hasta que apruebes al remitente.

4. Apruébate

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   El código es válido durante una hora, así que no tardes demasiado. El primer remitente aprobado se convierte automáticamente en el propietario de los comandos privilegiados.

Hay dos aspectos complicados con los que la gente suele tropezar.

El primero son los grupos. OpenClaw bloquea todos los grupos de forma predeterminada: debes permitir explícitamente el bot en el ajuste channels.telegram.groups y dejar activado el modo requireMention: true dentro del grupo. Así, solo responderá cuando lo mencionen por su nombre de usuario y no se meterá en la conversación general. Telegram también tiene su propio modo de privacidad para bots: en un grupo, un bot solo ve comandos de forma predeterminada. Desactívalo con /setprivacy mediante @BotFather. Después de cambiarlo, debes quitar el bot del grupo y volver a añadirlo; de lo contrario, Telegram no aplicará el ajuste.

El segundo es no abrir el acceso a todo el mundo. Los ajustes incluyen el modo dmPolicy: "open", con un asterisco en la lista de acceso: cualquiera que encuentre el bot por su nombre de usuario puede darle órdenes. En un asistente personal, eso equivale a darle a otra persona el control directo de tu ordenador. Deja activado el emparejamiento por código o introduce tu ID numérico en allowFrom.

¿Cómo usar OpenClaw con un modelo local mediante Ollama?#

Esta opción mantiene la inferencia del modelo en tu equipo si eliges una vía exclusivamente local, sin alternativa en la nube, y no necesita un endpoint de modelo de pago. Eso no hace local todo el flujo de Telegram: los mensajes siguen pasando por Telegram y las herramientas online activadas pueden enviar datos a otros servicios.

1. Instala Ollama

   Descarga el instalador desde ollama.com/download; hay versiones para macOS, Windows y Linux.

2. Descarga un modelo

   ollama pull gemma4
   

3. Conecta Ollama a OpenClaw

   openclaw onboard
   

   Elige el proveedor Ollama y un modo: Local only (tus propios modelos), Cloud only (modelos de ollama.com) o Cloud + Local. El asistente encontrará el servidor local y mostrará los modelos instalados.

4. Comprueba

   openclaw models list --provider ollama
   

Esta es la advertencia sincera sin la cual esta sección parecería un anuncio. La documentación de OpenClaw dice claramente que, para usar agentes cómodamente con un modelo local, hace falta un equipo del nivel de dos Mac Studios al máximo de capacidad, mientras que una tarjeta gráfica de 24 GB solo puede manejar solicitudes ligeras, con demoras. Los modelos pequeños y muy comprimidos recortan el contexto y son menos resistentes a las instrucciones maliciosas ocultas en textos ajenos. En términos cotidianos: un modelo local en un buen portátil basta para «probarlo y entender de qué va», pero un modelo en la nube sigue siendo mucho más fiable para el trabajo diario con un asistente que usa herramientas.

Una advertencia más de la documentación para quienes estén preparando una configuración de WSL2 + Ollama + GPU NVIDIA: el instalador oficial de Ollama para Linux activa el inicio automático con una política de reinicio «always», y en WSL2 con una GPU esto puede poner el equipo en un bucle de reinicios. La solución es desactivar el inicio automático del servicio. Si te ocurre, consulta la sección de resolución de problemas en la página de Ollama de la documentación.

¿Es seguro ejecutar OpenClaw?#

Empezaré por el punto principal, que no todo el mundo entiende. OpenClaw tiene acceso a tu equipo: archivos, comandos y navegador. La documentación lo explica claramente: el proyecto está diseñado para un único usuario de confianza y no debes dar acceso a tu bot a personas externas. Si alguien puede enviar mensajes a tu agente, puede utilizarlo para actuar en tu ordenador.

Lo mínimo práctico:

1. Mantén activado el emparejamiento por código o utiliza una lista de acceso; expliqué cómo configurarlo en la sección de Telegram.
2. No expongas la pasarela externamente si no lo necesitas. De forma predeterminada, solo escucha en tu equipo; déjala así.
3. Ejecuta la comprobación integrada después de cualquier cambio de configuración:

openclaw security audit

Comprueba si hay acceso abierto, permisos de herramientas demasiado amplios, tokens débiles y puertos expuestos. Con la opción --fix, algunos problemas se pueden corregir automáticamente.

Una nota aparte sobre las estafas: esto no es hipotético. Cuando el proyecto cambió de nombre a toda prisa en enero de 2026, bots ocupantes se hicieron con las antiguas direcciones en cuestión de segundos y publicaron de inmediato una cartera de criptomonedas; falsos «desarrolladores de OpenClaw» empezaron a promocionar una estafa con tokens. De ahí salen dos reglas innegociables. Descarga OpenClaw únicamente desde openclaw.ai o github.com/openclaw/openclaw. Y el proyecto no tiene criptomoneda: cualquier «token de OpenClaw» es una estafa. No envíes dinero bajo ninguna circunstancia.

¿Qué puede hacer OpenClaw después de instalarlo?#

Esto es lo que probaría, en este orden:

1. Pasarela y modelo. Ejecuta openclaw gateway status y abre openclaw dashboard. Cargar el panel confirma que Control UI es accesible. En su chat, envía «Responde: model connection test» y comprueba que llegue una respuesta de IA; abrir la página no prueba el modelo.
2. Telegram y la tarea prevista. Tras configurar el bot y aprobar tu emparejamiento, envíale un mensaje nuevo en Telegram y comprueba que la respuesta llegue allí. Prueba después una tarea acotada con resultado visible, como resumir una carpeta inocua cuya lectura hayas autorizado. Para un recordatorio, comprueba por separado el horario guardado y la entrega. Una respuesta en el panel no demuestra entrega en Telegram ni ejecución programada.
3. Tareas programadas. El asistente puede ejecutar tareas según un horario: un resumen matutino en Telegram o revisiones periódicas del correo electrónico. Por eso dejas la pasarela funcionando las 24 horas.
4. Memoria. OpenClaw guarda su memoria a largo plazo en archivos Markdown corrientes en su carpeta de trabajo: quién eres, cómo debe responderte y qué recuerda de conversaciones anteriores. Puedes abrir los archivos y leerlos tú mismo: no hay ninguna caja negra.
5. Habilidades. El proyecto tiene un catálogo de habilidades y complementos listos para usar, con comprobaciones de seguridad integradas. La habilidad de otra persona es código de otra persona en tu equipo; por eso el catálogo las revisa.

Hay una regla: no lo actives todo de golpe. Empieza con una conversación estable, luego Telegram y después los horarios. Así, cada fallo aparecerá en su propio paso, en lugar de acabar con «todo se ha roto y no sé dónde».

¿Qué hacer si algo falla durante la instalación?#

Veamos tres situaciones habituales.

«openclaw: command not found» justo después de la instalación. Casi siempre se debe a una ruta incorrecta: la carpeta de paquetes globales de npm no está en el PATH de tu terminal. Los comandos de diagnóstico de la documentación son:

node -v
npm prefix -g
echo "$PATH"

La ruta del segundo comando debería aparecer en el tercero. Si no aparece, añádela a la configuración de tu shell o simplemente cierra y vuelve a abrir el terminal: a veces la ruta de Node solo aparece en una sesión nueva tras la instalación.

La pasarela funciona, pero el asistente no responde. El síntoma descrito en las preguntas frecuentes de la documentación: no hay respuesta al primer mensaje y el contador de tokens está en cero. Eso significa que el agente ni siquiera se ha iniciado; lo más habitual es que el modelo no esté configurado. Comprueba esto en este orden:

openclaw gateway restart
openclaw status
openclaw models status

Si hay un modelo configurado y sigue sin responder, openclaw logs --follow mostrará el registro en directo y dónde se está atascando.

El bot de Telegram no responde. Comprueba esto en este orden: el token pertenece al bot al que estás escribiendo; la pasarela está en marcha (openclaw gateway status); y se ha aprobado tu emparejamiento (openclaw pairing list telegram). El código de emparejamiento es válido durante una hora: si escribiste al bot ayer, vuelve a escribirle y aprueba el nuevo código.

Si te quedas completamente atascado, la documentación sugiere algo inesperado pero sensato: darle los diagnósticos a un agente de IA local que pueda ver tu equipo. Claude Code o Codex pueden interpretar la configuración más rápido que un chat de soporte si les proporcionas la salida de openclaw status --all y openclaw doctor. Se cierra el círculo: la IA arregla la IA.

¿Qué otras preguntas hace la gente sobre OpenClaw?#

Conoce Ailoot.