Casi todos los chatbots de IA solo saben hablar. OpenClaw es un asistente gratis y de código abierto que corre en tu propia computadora y de verdad hace cosas, y le escribes directo desde Telegram o WhatsApp, como si le mandaras mensajes a un amigo súper capaz. Aquí te explico qué es, para qué sirve y un paso a paso con calma para echarlo a andar.
En resumen
- OpenClaw es un asistente de IA gratis y de código abierto que corre en tu propia computadora, no en la página web de otro.
- Le escribes desde apps que ya usas, sobre todo Telegram y WhatsApp, como cuando le mandas mensajes a un asistente.
- A diferencia de un chatbot común, sí puede hacer tareas: leerte el correo, manejarte el calendario, encargarse de mandados pequeños.
- OpenClaw en sí no cuesta nada; solo pagas por el cerebro de IA al que lo conectas (o usas uno local gratis).
- Tú llevas el control: solo le responde a la gente que apruebas, y lo desconectas cuando quieras.
Imagínate que pudieras contratar a un asistente inteligente que nunca se cansa, pero en vez de darle un escritorio en tu oficina, lo agregas a los contactos de tu teléfono y ya. Le escribes por WhatsApp: «Recuérdame llamar al banco a las 3», y pasa. Le mandas un mensaje por Telegram: «¿Qué reuniones tengo mañana?», te revisa el calendario y te lo dice. Esa es la idea detrás de OpenClaw.
Antes de arrancar, una nota honesta y rápida. OpenClaw puede hacer cosas de verdad por ti, y las herramientas que actúan en tu nombre piden un poco de cuidado. Esta guía mantiene todo accesible para principiantes, te explica cada término nuevo y es franca con los detalles que dan lata. Sin exageraciones, sin venderte que todo se hace con un clic mágico.
Nota
No necesitas saber programar para entender esta guía. Eso sí, configurar OpenClaw implica escribir algunos comandos en tu computadora. Los vamos a ver uno por uno y te explico qué hace cada uno en palabras sencillas.
01 · Qué es OpenClaw en realidad
Un chatbot de IA común es como una persona brillante encerrada en un cuarto: puede pensar y hablar, pero no puede tocar nada del mundo real. OpenClaw es otra cosa. Es un programa pequeño que corre en tu propia computadora (tu laptop o una maquinita siempre prendida), y de verdad puede hacer cosas: abrirte el correo, llenar un formulario en la web, ejecutar tareas pequeñas, no solo hablar de ellas.
Dos definiciones sencillas que vas a necesitar:
- Código abierto (open-source) quiere decir que la receta del programa es pública y gratis. Cualquiera puede leerla, usarla y mejorarla. No se la alquilas a una empresa; tu copia es tuya.
- Agente es la palabra elegante para una IA que puede tomar acciones por su cuenta, no solo responder preguntas. Piensa en «alguien que hace», no solo «alguien que habla».
A OpenClaw lo creó un desarrollador llamado Peter Steinberger junto con una comunidad de voluntarios. Su mascota es una langosta espacial, y en broma el proyecto llama a su estilo «el camino de la langosta». Es gratis de usar. (Quizás leas por ahí que su creador después entró a una gran empresa de IA. Tómalo como dato curioso; el proyecto sigue siendo independiente y de código abierto.)
Lo ingenioso es la interfaz, la forma en que le hablas. En lugar de otra página web más para iniciar sesión, OpenClaw vive dentro de apps de mensajería que ya tienes. Le escribes como a un amigo, y te contesta. Telegram y WhatsApp son las dos que vamos a configurar aquí.
02 · Para qué sirve (ejemplos reales)
Aquí va la lista honesta y concreta de para qué usa la gente OpenClaw. Fíjate que son acciones, no solo respuestas:
- Poner orden en tu bandeja de entrada: leer el correo nuevo, resumirlo, redactar respuestas, botar la basura.
- Calendario y agenda: revisar tu día, agregar eventos, acomodar horarios de reuniones.
- Cosas de viaje: el check-in de los vuelos y otras tareas pequeñas y repetitivas del viaje.
- Tareas en la web: navegar un sitio por ti, llenar un formulario, reunir información.
- Archivos en tu computadora: encontrar, organizar y ordenar tus archivos.
- Tareas que corren con temporizador: «todas las mañanas a las 8, mándame el clima y mi agenda».
- Memoria: se acuerda de conversaciones anteriores, así no tienes que repetirte.
Consejo
La mejor primera tarea es algo pequeño y que se pueda deshacer, como «resúmeme el correo sin leer» en lugar de «bórrame todos los archivos viejos». Observa cómo se porta antes de confiarle algo grande.
Si te dedicas a construir cosas, OpenClaw hasta te puede ayudar con trabajo de programación e investigación. Pero para alguien que va empezando, el valor es más simple: es un asistente que vive en tu app de chat y te resuelve cositas.
03 · Qué necesitas antes de empezar
No necesitas mucho. Aquí va la lista corta:
- Una computadora con una versión reciente de macOS, Windows o Linux. (Las Mac necesitan macOS 15 o más nuevo; Windows necesita Windows 10 versión 20H2 o Windows 11.)
- Unos minutos. La configuración básica toma unos cinco.
- Una «API key» para un cerebro de IA. Esta es la única parte que podría costarte dinero, ya te explico enseguida.
¿Qué es una API key? Piénsala como una contraseña que le permite a tu OpenClaw hablar con un cerebro de IA que vive en internet, como Claude de Anthropic o GPT de OpenAI. OpenClaw es el cuerpo y las manos; la API key lo conecta al cerebro que piensa. Esa key la sacas de la página web de la empresa de IA y la pegas en OpenClaw una sola vez.
Importante
OpenClaw en sí es totalmente gratis. Lo que pagas es el cerebro de IA que usa, y lo cobra la empresa que lo hace, normalmente un montito pequeño por uso. Si conectas un «modelo local» (una IA que corre en tu propia computadora), no hay ningún costo por uso. OpenClaw no tiene suscripción de ningún tipo, en ningún lado.
Un término más: el token. Las empresas de IA cobran por tokens, que son pedacitos de texto (más o menos una palabra o parte de una palabra). Más trabajo significa más tokens, y eso significa un poquito más de costo. Para un uso personal ligero, normalmente es un gasto mínimo.
04 · Instalar OpenClaw, paso a paso
Instalar significa poner el programa en tu computadora. Esto lo haces en la Terminal, una ventana de puro texto donde escribes comandos en vez de hacer clics. En una Mac, abre la app que se llama Terminal. En Windows, abre «PowerShell» o «Terminal». Se ve bien pelada, pero no es más que un lugar para escribir instrucciones.
La forma más sencilla en Mac o Linux es una sola línea. Cópiala, pégala en la Terminal y dale a Enter:
curl -fsSL https://openclaw.ai/install.sh | bash
En palabras sencillas: esto descarga el instalador oficial de OpenClaw y lo corre. (Si estás en Windows o prefieres otro camino, la documentación oficial también ofrece instalarlo con una herramienta llamada npm, que es un instalador común para este tipo de software.)
Una vez instalado, corres el asistente de configuración. Un asistente (wizard) es una configuración guiada paso a paso que te va haciendo preguntas una por una:
openclaw onboard --install-daemon
El asistente te lleva por lo básico y configura un daemon, la palabra para un ayudante pequeño que corre calladito en el fondo, para que OpenClaw siempre esté listo, hasta después de que cierres la ventana. El asistente te preguntará qué cerebro de IA quieres usar y dónde pegar tu API key.
Para ver un panel de control fácil de usar en tu navegador, puedes abrir el dashboard:
openclaw dashboard
Eso abre una página web local (normalmente en una dirección que empieza con http://127.0.0.1 (opens in new tab), que solo quiere decir «en esta misma computadora»). No te preocupes si un detalle como la dirección exacta cambia un poquito. El asistente te dice dónde buscar.
Nota
Si algún comando falla, casi siempre es cuestión de versiones. A OpenClaw le gusta una versión reciente de Node (un software sobre el que corre, versión 22.19+ o 24). El instalador de una línea normalmente se encarga de esto por ti, así que pruébalo primero.
05 · Conectarlo a Telegram
Telegram es la app más fácil de conectar, y la documentación oficial coincide en que es la más rápida. La idea completa es esta: creas un bot pequeño (una cuenta automática) dentro de Telegram, sacas su contraseña secreta y le entregas esa contraseña a OpenClaw.
Paso 1, crea el bot. En Telegram, busca la cuenta oficial @BotFather (un bot que crea otros bots). Mándale el mensaje /newbot y sigue las preguntas. Te pide un nombre y un nombre de usuario. Al final te da una cadena secreta larga llamada token. Cópiala y guárdala bien; es la contraseña del bot.
Paso 2, dale el token a OpenClaw. La forma más sencilla es ponerlo como variable de entorno, un ajuste que tu computadora recuerda. En la Terminal:
TELEGRAM_BOT_TOKEN=tu_token_aqui
(Reemplaza «tu_token_aqui» por el token real.) Si prefieres, también puedes escribirlo en el archivo de ajustes de OpenClaw; la documentación muestra las dos formas.
Atención
Telegram no usa un comando de «login» como otras apps. No intentes «openclaw channels login telegram», no va a funcionar. Para Telegram, pones el token (como arriba) y luego arrancas el gateway en el siguiente paso.
Paso 3, arráncalo y apruébate a ti mismo. El gateway es la parte de OpenClaw que se conecta a tus apps de chat. Arráncalo:
openclaw gateway
La primera vez que le escribes a tu bot, OpenClaw usa pairing (emparejamiento), un chequeo de seguridad en el que una persona nueva tiene que ser aprobada antes de que el bot le hable. Te apruebas a ti mismo así:
openclaw pairing list telegram
openclaw pairing approve telegram EL_CODIGO_MOSTRADO
El primer comando te muestra las solicitudes pendientes con un código; el segundo lo aprueba. Ahora escríbele a tu bot en Telegram y te va a responder.
Importante
Los códigos de pairing se vencen después de una hora. Si el tuyo deja de funcionar, vuelve a escribirle al bot para que te dé un código nuevo, y luego apruébalo.
06 · Conectarlo a WhatsApp
WhatsApp funciona un poco distinto. Aquí no hay contraseña de bot que copiar. En cambio, OpenClaw se enlaza con tu WhatsApp escaneando un código QR con tu teléfono, igualito que funciona WhatsApp Web en una computadora.
Paso 1, agrega la pieza de WhatsApp. Esto instala la parte que habla con WhatsApp:
openclaw channels add --channel whatsapp
Paso 2, di quién tiene permiso. En los ajustes de OpenClaw, anota los números de teléfono que pueden usarlo. Los números deben ir en formato E.164, que solo quiere decir un signo de más, el código de país y luego el número, sin espacios. Por ejemplo, un número de República Dominicana se vería así: +18091234567.
Paso 3, arranca el login con QR.
openclaw channels login --channel whatsapp
Aparece un código QR (un cuadrito de barras). En tu teléfono, abre WhatsApp, entra a Dispositivos vinculados, toca Vincular un dispositivo y escanea el código de la pantalla. Eso le dice a WhatsApp que confíe en tu OpenClaw.
Paso 4, aprueba y arranca. Igual que con Telegram, el primer mensaje usa pairing. Apruébalo y luego arranca el gateway:
openclaw pairing approve whatsapp EL_CODIGO_MOSTRADO
openclaw gateway
Atención
Las conexiones de WhatsApp aquí usan un método no oficial (el mismo de WhatsApp Web). Funciona bien para uso personal, pero es menos sólido que el servicio oficial para empresas. El enlace se puede caer de vez en cuando y tocarte volver a escanear. Para un asistente casual esto está bien; solo ten claro que no es una garantía.
07 · Tropiezos honestos, en palabras sencillas
Hay algunas cosas que confunden a quien va empezando. Conocerlas de antemano te ahorra una noche de frustración:
- Telegram y WhatsApp se configuran distinto. Telegram = copiar un token. WhatsApp = escanear un código QR. No intentes usar el método de uno en el otro.
- Los códigos de pairing se vencen en una hora. Si la aprobación falla, saca un código nuevo escribiéndole otra vez al bot. (WhatsApp además te limita a tres solicitudes pendientes a la vez.)
- El formato del número importa. Para WhatsApp en OpenClaw, incluye siempre el signo de más: +18091234567.
- Mantén tus tokens en secreto. Tu token de Telegram es una contraseña. Si alguna vez se te filtra, vuelve a @BotFather y revócalo con /revoke, luego usa el nuevo.
- OpenClaw no es la única herramienta de este tipo. Quizás veas un proyecto parecido llamado Hermes (hecho por otro grupo). Son primos, no el mismo producto, y sus comandos no se pueden mezclar. No combines instrucciones de «openclaw» y «hermes».
Consejo
Empieza chiquito y observa. Conecta solo Telegram primero, dale una tarea inofensiva y mira qué tal. Agrega WhatsApp y trabajos más grandes solo cuando ya le tengas confianza. Ese hábito de constructor a constructor, empieza pequeño, compruébalo y después expande, te mantiene seguro y tranquilo.
Ya tienes el panorama completo: OpenClaw es un asistente gratis y de código abierto que vive en tu propia computadora y trabaja a través de las apps de chat que ya usas. De verdad hace cosas, no solo habla. Lo conectas a un cerebro de IA con una API key, lo configuras con un asistente cortito y le llegas desde Telegram (con un token) o WhatsApp (con un escaneo QR). Tú decides a quién le hace caso, lo desconectas cuando quieras y solo pagas por el cerebro que elijas. Su casa oficial, con la documentación más reciente, está en https://openclaw.ai/ (opens in new tab). Empieza pequeño, mantén la curiosidad y deja que tu langosta espacial se gane tu confianza una tarea a la vez.
Puntos clave
- OpenClaw es un asistente de IA gratis y de código abierto que corre en tu propia computadora y de verdad hace tareas, no solo chatea.
- Le llegas desde apps que ya usas: Telegram (se configura con un token) y WhatsApp (se configura escaneando un código QR).
- El programa es gratis; solo pagas por el cerebro de IA que conectas con una API key, o usas un modelo local gratis.
- Tú llevas el control: el pairing significa que solo la gente que apruebas puede usarlo, y lo desconectas cuando quieras.
- Empieza pequeño: conecta Telegram primero, dale una tarea inofensiva y expande solo cuando ya le tengas confianza.
Preguntas frecuentes
¿OpenClaw es realmente gratis?
Sí. OpenClaw en sí es gratis y de código abierto, sin ninguna suscripción en ningún lado. Lo único que podría costarte dinero es el cerebro de IA al que lo conectas (como Claude o GPT), que la empresa de IA cobra por uso, normalmente un montito pequeño. Si conectas un modelo local que corre en tu propia computadora, hasta ese costo desaparece. O sea: el programa es gratis; el pensamiento que toma prestado quizás no.
¿Tengo que ser programador para usarlo?
No, pero sí tienes que escribir algunos comandos en una ventana de Terminal durante la configuración. Eso puede dar un poco de nervios la primera vez. En realidad es solo copiar y pegar las líneas de esta guía y darle a Enter. Ya configurado, le hablas a OpenClaw completito por Telegram o WhatsApp, como cuando le escribes a un amigo. En el día a día no hay nada de programación.
¿Por qué Telegram es más fácil de conectar que WhatsApp?
Telegram tiene una forma oficial y fácil de crear bots: le pides a @BotFather un token (una contraseña), lo pegas en OpenClaw y listo. WhatsApp no tiene un bot oficial para este tipo de uso personal, así que OpenClaw se enlaza escaneando un código QR, igual que funciona WhatsApp Web. Ese método funciona bien, pero es un poquito menos estable. El enlace se puede caer de vez en cuando y tocarte volver a escanear. La propia documentación oficial llama a Telegram la más rápida de configurar.
¿Cualquiera puede escribirle a mi bot y controlarlo?
No. OpenClaw usa «pairing», lo que significa que cualquier persona nueva tiene que ser aprobada por ti antes de que el bot le responda, y puedes anotar exactamente qué números de teléfono o cuentas tienen permiso. Así que por defecto ignora a los desconocidos. Los códigos de aprobación además se vencen después de una hora, por seguridad extra. Tú siempre tienes la última palabra.
¿Conectar OpenClaw a WhatsApp es seguro para mi cuenta?
Para uso personal por lo general está bien, pero sé honesto contigo sobre la concesión. OpenClaw se enlaza por el método no oficial de WhatsApp Web, no por el servicio oficial para empresas. Eso significa que la conexión se puede romper y tocarte volver a escanear, y en teoría una cuenta muy automatizada podría quedar marcada. Para un asistente personal ligero esto rara vez es un problema. Si WhatsApp te da nervios, empieza con Telegram. Es más fácil y más estable.
He visto algo que se llama Hermes, ¿es lo mismo?
No. Hermes es un asistente de IA parecido hecho por otro grupo, y a menudo los comparan, pero son productos distintos con comandos distintos. Si estás siguiendo una guía de OpenClaw, quédate con los comandos «openclaw»; no pegues comandos «hermes», y al revés tampoco. Mezclarlos es un error común de principiante que termina en errores confusos.
¿Prefieres que lo hagamos por ti?
Esto mismo lo construimos para negocios como el tuyo. La primera conversación es gratis y sin compromiso.
Escríbenos por WhatsAppPrimera conversación gratis. Te responde el fundador.
Recursos relacionados
Hermes Agent para principiantes: tu propio asistente de IA en Telegram y WhatsApp
Un ayudante que corre en una computadora que tú controlas, que recuerda lo que le enseñas y que te responde desde las apps de chat que ya usas. Eso es Hermes Agent, una herramienta gratis y de código abierto de Nous Research. Esta guía te explica, en palabras sencillas, qué es, y te lleva paso a paso a instalarlo y conectarlo a Telegram y WhatsApp. Sin necesidad de saber programar.
La app de escritorio de Hermes Agent: instálala y déjala lista, paso a paso
Hermes Agent ahora tiene una app de escritorio: una ventana de verdad en tu Mac o Windows, sin necesidad de terminal. Este es un recorrido en lenguaje sencillo sobre qué es, en qué se diferencia de la versión chat-bot, y cómo instalarla y dejarla lista paso a paso.
Hacer streaming de llamadas a herramientas de la API de Claude dentro de un bucle
Hacer streaming con herramientas es un bucle agéntico, no una sola llamada: vas emitiendo tokens para que la respuesta se sienta ágil, pausas cuando Claude pide una herramienta, la ejecutas, le devuelves el resultado y sigues con el streaming hasta que el turno se cierra. Esta guía recorre el bucle completo en TypeScript con eventos reales del SDK, las reglas de forma del mensaje que la API exige y los fallos que más duelen en producción.