1. Portada
  2. Configuración
  3. OpenClaw
Configuración · unos 30 minutos

Cómo instalar OpenClaw: guía de configuración con Telegram

Reserva alrededor de media hora para pasar de una máquina vacía a un agente autohospedado que responde en Telegram y sigue las reglas que tú mismo has escrito.

Paso a paso

  1. Elige dónde se ejecutará

    Un portátil sirve para probar OpenClaw, pero si quieres que el agente esté disponible a cualquier hora, es mejor usar un equipo siempre encendido, como un servidor doméstico o un VPS alquilado, porque solo puede responder mientras la máquina esté funcionando. Elijas lo que elijas, el puerto del gateway nunca debe quedar expuesto a internet.

  2. Instala OpenClaw

    Usa el instalador oficial que corresponda a tu sistema. Detecta el sistema operativo, instala Node si falta, configura OpenClaw y, a continuación, inicia la configuración inicial.

    # macOS / Linux / WSL2
    curl -fsSL https://openclaw.ai/install.sh | bash
    
    # Windows (PowerShell)
    iwr -useb https://openclaw.ai/install.ps1 | iex
  3. Completa la configuración inicial y ejecuta el gateway como servicio

    La configuración inicial ofrece Quick start, que reutiliza cualquier acceso a IA que encuentre, o Custom setup, que muestra todas las opciones. Cuando termine, detén el gateway en primer plano y regístralo como servicio en segundo plano, para que se reinicie automáticamente al reiniciar el equipo.

    openclaw onboard
    # stop the foreground gateway with Ctrl+C, then run it as a service:
    openclaw gateway install
  4. Conecta Telegram

    En Telegram, abre un chat con @BotFather y comprueba bien que el nombre de usuario sea correcto. Envía /newbot y guarda el token que recibas. Registra Telegram como canal con ese token y ejecuta una comprobación de estado para verificar la conexión.

    openclaw channels add --channel telegram --token <bot-token>
    openclaw channels status --probe
  5. Aprueba el emparejamiento

    Envía un mensaje a tu bot. En vez de responder, dará un código de emparejamiento a quienes no reconozca. Busca las solicitudes pendientes y aprueba la tuya antes de que pase una hora.

    openclaw pairing list telegram
    openclaw pairing approve telegram <CODE>
  6. Ejecuta la auditoría de seguridad y mantén todo actualizado

    Deja que la auditoría de seguridad de OpenClaw revise la configuración y resuelve los problemas que señale. Después, instala las actualizaciones del canal estable. Las versiones anteriores a 2026.4.22 están expuestas a vulnerabilidades críticas conocidas, así que convierte ambos comandos en parte de tu rutina.

    openclaw security audit
    openclaw update --channel stable
  7. Escribe sus reglas permanentes

    Escribe tus reglas en lenguaje sencillo en AGENTS.md, dentro del espacio de trabajo del agente, y establece límites estrictos equivalentes en ~/.openclaw/openclaw.json. Comprueba los nombres de las claves en la documentación de tu versión. Mantén dmPolicy en pairing y configura las aprobaciones de exec para que te pregunten siempre, hasta que tengas confianza en la configuración.

La primera semana

Considera la primera semana como un periodo de prueba. El gateway debe permanecer en loopback; accede a él mediante Tailscale o SSH, no a través de un puerto expuesto. Mantén los comandos de shell sujetos a aprobación, añade pocas habilidades de terceros y solo de editores que conozcas, y revisa a diario el uso del modelo: si el agente entra en un bucle, seguirá consumiendo tokens. Vuelve a ejecutar la auditoría de seguridad después de cada cambio en la configuración.

Errores que conviene evitar

  • Exponer el gateway a internet en vez de dejar gateway.bind configurado en loopback.
  • Instalar un montón de habilidades de terceros, que merecen la misma cautela que las extensiones del navegador.
  • Usar una versión obsoleta: todas las anteriores a 2026.4.22 tienen vulnerabilidades críticas conocidas.