Cómo instalar OpenClaw y conectar Telegram
Calcula alrededor de media hora desde una máquina recién configurada hasta tener un agente que te responda en Telegram. Los comandos que se muestran provienen de la documentación oficial, así que compáralos con los de la versión que instales.
Qué necesitas
- Una computadora o un VPS con macOS, Linux, WSL2 o Windows
- Node 24.16+ o Node 26, que el instalador puede agregar por ti
- Una clave API o una suscripción para un modelo, o un modelo local
- Una cuenta de Telegram
Paso a paso
-
Elige una máquina y crea un bot
Una laptop sirve para probarlo, pero para un agente que esté siempre activo conviene usar un VPS pequeño o un servidor en casa. El puerto del gateway nunca debe quedar abierto a Internet. En Telegram, envíale un mensaje a @BotFather después de verificar cuidadosamente el nombre de usuario, ejecuta /newbot y copia el token que te dé.
-
Instala OpenClaw
Ejecuta el instalador oficial para tu sistema. Detecta el sistema operativo, agrega Node si no está instalado, instala OpenClaw y luego inicia la configuración.
# macOS / Linux / WSL2 curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex
-
Completa la configuración e instala el servicio gateway
Elige Quick start para reutilizar el acceso a IA que detecte, o Custom setup para configurar cada opción. Cuando termine la configuración inicial, detén el gateway que se esté ejecutando en primer plano e instálalo como servicio en segundo plano para que se reinicie después de reiniciar el equipo.
openclaw onboard # after the quick start, stop the foreground gateway (Ctrl+C), then: openclaw gateway install
-
Agrega el canal de Telegram
Agrega Telegram como canal usando el token de tu bot. Luego, consulta el estado del canal para confirmar que la conexión funciona.
openclaw channels add --channel telegram --token <bot-token> openclaw channels status --probe
-
Aprueba tu emparejamiento
Envía cualquier mensaje a tu bot. Los remitentes desconocidos reciben un código de emparejamiento en lugar de una respuesta, así que revisa las solicitudes pendientes y aprueba tu código dentro de una hora.
openclaw pairing list telegram openclaw pairing approve telegram <CODE>
-
Haz una auditoría y actualiza
Ejecuta la auditoría de seguridad integrada y actualiza desde el canal estable. Las versiones anteriores a 2026.4.22 tienen vulnerabilidades críticas conocidas, así que no te quedes en una de ellas.
openclaw security audit openclaw update --channel stable
Primeras cosas que debes hacer después de la configuración
- Deja dmPolicy en pairing para que los desconocidos que encuentren tu bot no puedan usarlo.
- Configura las aprobaciones de exec para que siempre pidan confirmación hasta que confíes en tu configuración.
- Repite periódicamente la auditoría de seguridad y la actualización.
Errores comunes
- Exponer el puerto de la puerta de enlace en lugar de mantener gateway.bind en loopback y conectarte por SSH o Tailscale.
- Instalar muchas habilidades de terceros: trátalas como extensiones del navegador y agrega solo unas pocas de fuentes confiables.
- Olvidar que un agente atrapado en un bucle sigue consumiendo tokens del modelo.