Configurando Tu Primer Canal

OpenClaw soporta múltiples plataformas de mensajería. Para este tutorial, usaremos Telegram porque:

• El más fácil de configurar (solo crear un bot)
• No se requiere número de teléfono
• Genial para pruebas y aprendizaje
• Funciona en todas las plataformas

Para otros canales: Ver la Referencia de Canales para WhatsApp, Discord, Slack, Signal, iMessage y más.

Telegram usa bots, que son cuentas especiales que pueden ser controladas programáticamente. Así es como crear uno:

Paso 2.1: Abre Telegram y Encuentra BotFather

• Abre la app de Telegram en tu teléfono o computadora
• Busca @BotFather (creador oficial de bots de Telegram)
• Inicia una conversación con BotFather
• Envía el comando: /start

Paso 2.2: Crea Tu Bot

• Envía a BotFather: /newbot
• BotFather pedirá un nombre para tu bot (este es el nombre para mostrar, ej., "Mi Asistente OpenClaw")
• BotFather pedirá un nombre de usuario (debe terminar en 'bot', ej., "miopenclawbot")
• BotFather responderá con un token de bot - COPIA ESTE TOKEN (lo necesitarás en el siguiente paso)

Paso 2.3: (Opcional) Configura Tu Bot

Puedes personalizar tu bot con comandos de BotFather:

• /setdescription - Establece qué hace tu bot
• /setabouttext - Establece la biografía del bot
• /setuserpic - Establece la foto de perfil del bot

Estos son opcionales - tu bot funcionará sin ellos.

Ahora agregaremos tu bot de Telegram a la configuración de OpenClaw.

Paso 3.1: Abre el Archivo de Configuración

Tu configuración de OpenClaw está ubicada en ~/.openclaw/openclaw.json. Ábrelo en tu editor de texto preferido:

# On macOS/Linux:
nano ~/.openclaw/openclaw.json
# or
code ~/.openclaw/openclaw.json  # VS Code
# or
open ~/.openclaw/openclaw.json  # Default editor

Paso 3.2: Agrega la Configuración de Telegram

Agrega la configuración del canal Telegram a tu archivo. Si ya tienes un archivo de configuración, agrega la sección channels:

{
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-opus-4-5" }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN_HERE"
    }
  }
}

Reemplaza YOUR_BOT_TOKEN_HERE con el token que copiaste de BotFather.

Paso 3.3: Guarda y Reinicia el Gateway

Después de guardar tu configuración:

• Guarda el archivo de configuración
• Reinicia tu Gateway de OpenClaw para cargar la nueva configuración

# If Gateway is running as a service:
openclaw gateway restart

# Or if running manually, stop and restart:
openclaw gateway --port 18789 --verbose

¡Ahora verifiquemos que todo funcione!

Paso 4.1: Encuentra Tu Bot en Telegram

• Abre Telegram
• Busca tu bot por su nombre de usuario (el que creaste, ej., "miopenclawbot")
• Inicia una conversación con tu bot
• Envía /start para inicializar el bot

Paso 4.2: Envía un Mensaje de Prueba

Envía un mensaje simple a tu bot, como:

• "¡Hola!"
• "¿Qué puedes hacer?"
• "Preséntate"

¡Tu asistente OpenClaw debería responder! Si lo hace, felicidades - ¡tu canal está funcionando! 🎉

El Bot No Responde

Si tu bot no responde:

• Verifica que el Gateway esté ejecutándose: openclaw gateway status
• Verifica que el token sea correcto: Revisa errores tipográficos en el archivo de configuración
• Revisa los registros del Gateway: Busca mensajes de error sobre la conexión de Telegram
• Reinicia el Gateway: A veces un reinicio soluciona problemas de conexión

Error "Bot token is invalid"

Esto generalmente significa:

• El token se copió incorrectamente (revisa espacios extra)
• El token fue regenerado (obtén uno nuevo de BotFather)
• El archivo de configuración tiene errores de sintaxis (revisa el formato JSON)

El Bot Responde pero el Gateway Muestra Errores

Si el bot funciona pero ves errores:

• Revisa los registros del Gateway para mensajes de error específicos
• Verifica que tu modelo de IA esté configurado correctamente
• Asegúrate de tener créditos/cuota API disponibles

Para más ayuda de solución de problemas, consulta nuestra Guía de Solución de Problemas.

Ahora que tienes un canal conectado, aquí está lo que puedes explorar a continuación:

Otros Canales

¿Quieres configurar otros canales? Aquí hay enlaces rápidos a sus guías de referencia:

• Configuración de WhatsApp - Emparejamiento con código QR con tu cuenta de WhatsApp
• Configuración de Discord - Crea un bot de Discord e invítalo a servidores
• Todos los Canales - Lista completa de plataformas de mensajería soportadas

Cada canal tiene su propio proceso de configuración, pero el flujo general es similar: crear/vincular cuenta → obtener credenciales → configurar OpenClaw → probar conexión.