OpenClaw (langosta) es actualmente el proyecto de código abierto de agentes de IA con la tasa de crecimiento más rápida en GitHub. Te permite montar en tu propia computadora un asistente de IA privado que está siempre en línea y conversar con él a través de apps de mensajería que usas normalmente, como Telegram, WhatsApp, Discord, etc.
Este tutorial, desde cero, te guía para completar la instalación, la configuración y el envío de tu primer mensaje; todo el proceso toma alrededor de 10 minutos.
¿Qué es OpenClaw? ¿En qué se diferencia de ChatGPT?
ChatGPT es una herramienta de preguntas y respuestas: tú le haces una pregunta y te entrega una respuesta; cuando termina la conversación, se acaba. OpenClaw es un agente de IA: tú le entregas una tarea, y él piensa por sí mismo, llama herramientas, ejecuta acciones: consulta tu Gmail, revisa tu calendario, busca en la web, escribe código… y luego te informa los resultados.
La diferencia más clave es esta: OpenClaw se ejecuta en tu propia computadora; los datos están completamente bajo tu control y no se suben a ningún servidor de terceros. Además, no incluye el modelo de IA en sí: necesitas proporcionar tú mismo una API Key (Anthropic Claude, OpenAI GPT, Google Gemini, etc.); el costo del modelo lo pagas directamente tú al proveedor.
Preparativos antes de la instalación
Requisitos del sistema
macOS, Linux, o Windows (se recomienda usar WSL2, mayor estabilidad)
Node.js 22.14 o superior (recomendado Node 24)
Al menos un conjunto de API Keys de modelos de IA
Instalar Node.js
Primero, confirma si está instalado y si la versión es suficiente:
node -v
Si la versión es inferior a v22.14 o aún no está instalado, elige el método de instalación según tu sistema:
Obtener la API Key del modelo de IA
OpenClaw admite múltiples proveedores de modelos; a continuación, las tres opciones más comunes:
Anthropic Claude: ve a console.anthropic.com para crear una cuenta y, en la página de API Keys, agrega una clave. Claude Sonnet 4.x es la opción más popular actualmente.
OpenAI GPT: ve a platform.openai.com y crea una API Key.
Google Gemini: ve a aistudio.google.com y podrás obtener una API Key de forma gratuita.
Copia la API Key y guárdala; más adelante, durante la instalación, tendrás que pegarla.
Paso 1: Instalar OpenClaw
En macOS y Linux basta con un solo comando:
curl -fsSL | bash
En Windows, los usuarios ejecutan en PowerShell:
iwr -useb | iex
Una vez completada la instalación, confirma que el comando se puede usar:
openclaw --version
Paso 2: Ejecutar el asistente Onboarding
Ejecuta el siguiente comando para iniciar el asistente de configuración interactivo, y al mismo tiempo hacer que OpenClaw arranque con el sistema como servicio en segundo plano:
openclaw onboard --install-daemon
El asistente te preguntará varias cosas en secuencia:
Elegir el proveedor del modelo: elige la compañía de la que obtuviste la API Key (Anthropic, OpenAI, Google, etc.)
Pegar la API Key: pega la clave que copiastes antes
Elegir el modelo: se recomienda elegir el modelo principal más reciente (por ejemplo, claude-sonnet-4-5)
Elegir el modo de instalación: para principiantes, elige QuickStart; usará valores predeterminados y completará toda la configuración
Todo el proceso toma alrededor de 2 minutos; la mayoría de opciones se pueden aceptar con Enter usando los valores predeterminados.
Paso 3: Confirmar que el Gateway está en ejecución
openclaw gateway status
Si ves que el Gateway escucha en el puerto 18789, significa que la instalación fue exitosa.
Abre la interfaz de control en el navegador para probar:
openclaw dashboard
Se abrirá el Control UI en el navegador; aquí puedes enviar mensajes directamente al asistente de IA para confirmar que todo funciona correctamente.
Paso 4: Integrar Telegram (la forma más rápida de empezar)
Telegram es el canal de mensajería con soporte oficial más completo para OpenClaw; la configuración también es la más sencilla y solo requiere un Bot Token.
4-1 Solicitar Bot Token a BotFather
Abre Telegram, busca y abre @BotFather (confirma que haya una marca azul oficial al lado)
Envía /newbot
Sigue las indicaciones para ingresar el nombre del Bot (nombre visible) y la cuenta del Bot (debe terminar en bot, por ejemplo my_ai_assistant_bot)
BotFather te dará un Token, con un formato similar a 123456789:AAGxxxxxxxxxxxxxxxxx; cópialo
4-2 Configurar el Token
Edita el archivo de configuración de OpenClaw (ruta predeterminada
~/.openclaw/config.json5
), y agrega la configuración de Telegram:
{ channels: { telegram: { enabled: true, botToken: “Pega aquí tu Token”, dmPolicy: “pairing”, }, }, }
4-3 Reiniciar Gateway y emparejar
openclaw gateway restart openclaw pairing list telegram
Luego, en Telegram, busca el Bot que acabas de crear y envíale cualquier mensaje; te dará un código de emparejamiento. Ejecuta:
openclaw pairing approve telegram <código de emparejamiento>
Después de eso, envía un mensaje a tu Bot en Telegram y recibirás la respuesta de tu asistente de IA.
Preguntas frecuentes (FAQ)
¿Qué hago si hay un error de versión de Node?
Ejecuta
node -v
para confirmar la versión. Si es inferior a v22.14, reinstala Node.js siguiendo la tabla anterior. Si eres usuario de macOS y tienes instalado Homebrew, ejecuta brew upgrade node para actualizar.
¿No se puede iniciar el Gateway?
Ejecuta
openclaw gateway status
para ver el mensaje de error. La causa más común es que el puerto 18789 esté ocupado o que el formato de la API Key sea incorrecto. Puedes ejecutar openclaw configure para volver a configurarlo.
¿Cómo cambio la API Key?
Ejecuta
openclaw configure
y, en el paso Model/Auth, elige volver a configurarlo.
¿El Token se quema todo el tiempo?
En condiciones predeterminadas, OpenClaw solo llama a la API cuando recibe mensajes y no consume el Token sin motivo. Pero si habilitas algunas Skill de automatización o tareas programadas, se recomienda configurar en la plataforma del proveedor del modelo un límite máximo de uso mensual para evitar gastos accidentales.
¿Qué puedo hacer a continuación?
Integrar Gmail y Google Calendar para que el asistente gestione tus correos y tu agenda
Instalar Skills para ampliar las capacidades del asistente (búsqueda en la web, ejecución de código, administración de memoria, etc.)
Despliegue en la nube: a través de Cloudflare Tunnel para mantener a la langosta en línea 24 horas (tutorial avanzado, próximamente)
Esta publicación, el tutorial completo de instalación de OpenClaw (IA de langosta) 2026: montar un asistente de IA personal desde cero e integrar Telegram, apareció por primera vez en Cadena de noticias ABMedia.
