Configuración de Canales Específicos (Discord, Telegram, WhatsApp, Web)

Esta lección aborda la configuración de los canales de comunicación en OpenClaw. Se detallan los parámetros necesarios para integrar el agente con plataformas como Discord, Telegram, WhatsApp y Web, permitiendo la interacción con usuarios finales. La correcta configuración es crítica para la operatividad del agente.

Principios de Conexión de Canales

La conexión de un agente OpenClaw a canales externos se gestiona a través de la sección `channels` del archivo de configuración principal (`config.yaml`). Cada canal requiere un bloque de configuración específico que incluye el tipo de canal y sus credenciales de autenticación. Estas credenciales son proporcionadas por la plataforma externa (ej. token de bot, clave de API) y permiten a OpenClaw interactuar con la API de dicho servicio.

Es fundamental entender que OpenClaw actúa como un cliente de estas plataformas. No modifica la infraestructura de los servicios de terceros, sino que utiliza sus mecanismos estándar para enviar y recibir mensajes. La seguridad de las credenciales es responsabilidad del administrador del agente y deben manejarse como secretos.

Configuración de Discord

Para conectar OpenClaw a Discord, se requiere un Bot Token. Este token se obtiene al crear una aplicación de bot en el Portal de Desarrolladores de Discord. El bot debe tener los permisos (intents) necesarios para leer mensajes y responder, como `Message Content Intent` y `Guild Messages`.

channels:
  - type: discord
    token: "TU_BOT_TOKEN_DE_DISCORD"
    # Opcional: prefijo para comandos, por defecto el nombre del agente
    # command_prefix: "!"
    # Opcional: IDs de canales o usuarios permitidos (lista de strings)
    # allowed_ids: ["123456789012345678", "987654321098765432"]

• `token`: La cadena de autenticación única para tu bot de Discord. Es un secreto y no debe ser expuesto públicamente.
• `command_prefix` (opcional): Carácter o cadena que el bot esperará antes de reconocer un comando. Si no se especifica, el agente responderá a menciones o a mensajes directos.
• `allowed_ids` (opcional): Una lista de IDs de usuarios o canales de Discord desde los cuales el agente aceptará interacciones. Si no se especifica, el agente puede interactuar en cualquier canal donde tenga permisos.

Configuración de Telegram

La conexión a Telegram se realiza mediante un Bot Token, obtenido a través de BotFather en Telegram. Este token permite a OpenClaw interactuar con la API de Telegram para enviar y recibir mensajes.

channels:
  - type: telegram
    token: "TU_BOT_TOKEN_DE_TELEGRAM"
    # Opcional: IDs de usuarios o chats permitidos (lista de enteros)
    # allowed_ids: [123456789, 987654321]

• `token`: El token de autenticación proporcionado por BotFather. Es un secreto.
• `allowed_ids` (opcional): Una lista de IDs numéricos de usuarios o chats de Telegram que pueden interactuar con el agente. Si no se especifica, el agente puede interactuar con cualquier usuario o chat que lo contacte.

Configuración de WhatsApp

La integración con WhatsApp es más compleja debido a las políticas de Meta. OpenClaw generalmente se conecta a través de la API de WhatsApp Business Cloud o mediante soluciones de terceros que actúan como gateways. Esto requiere un Token de Acceso Permanente, un ID de número de teléfono y un ID de cuenta de WhatsApp Business. La configuración puede variar ligeramente dependiendo del proveedor del gateway o si se utiliza directamente la API de Meta.

channels:
  - type: whatsapp
    # Si usas la API de WhatsApp Business Cloud de Meta
    access_token: "TU_TOKEN_DE_ACCESO_PERMANENTE"
    phone_number_id: "TU_ID_DE_NUMERO_DE_TELEFONO"
    whatsapp_business_account_id: "TU_ID_DE_WABA"
    # Opcional: URL del webhook si es necesario para recibir mensajes
    # webhook_url: "https://tu_servidor.com/webhook/whatsapp"
    # Opcional: Si usas un gateway de terceros, los parámetros pueden variar
    # gateway_url: "https://api.gateway.com/v1"
    # gateway_api_key: "TU_API_KEY_DEL_GATEWAY"

• `access_token`: Token de acceso permanente de la API de WhatsApp Business Cloud. Se obtiene del panel de desarrolladores de Meta.
• `phone_number_id`: Identificador numérico del número de teléfono registrado en WhatsApp Business API.
• `whatsapp_business_account_id`: Identificador de la cuenta de WhatsApp Business.
• `webhook_url` (opcional): URL donde OpenClaw espera recibir notificaciones de mensajes entrantes de WhatsApp. Esto debe ser una URL pública y accesible desde los servidores de Meta.
• Para soluciones de terceros, los parámetros como `gateway_url` y `gateway_api_key` son ejemplos y deben consultarse con la documentación específica del proveedor.

Configuración de Canal Web

El canal web proporciona una interfaz de chat basada en navegador, ideal para incrustar en sitios web o usar como una interfaz interna. No requiere tokens de terceros, ya que OpenClaw aloja el frontend directamente. La configuración principal es el puerto en el que escuchará el servidor web interno.

channels:
  - type: web
    port: 8080
    # Opcional: Ruta base para la interfaz web
    # base_path: "/chat"
    # Opcional: Habilitar HTTPS (requiere certificados)
    # ssl_cert: "/ruta/a/certificado.pem"
    # ssl_key: "/ruta/a/clave.pem"

• `port`: El número de puerto TCP en el que el servidor web de OpenClaw escuchará las conexiones entrantes. Asegúrate de que este puerto no esté en uso por otra aplicación y que sea accesible desde donde se espera que los usuarios se conecten.
• `base_path` (opcional): Permite definir una ruta URL base para la interfaz web, útil si se aloja detrás de un proxy inverso.
• `ssl_cert` y `ssl_key` (opcional): Rutas a los archivos de certificado y clave privada para habilitar HTTPS, lo cual es altamente recomendado para cualquier despliegue en producción.

Aplicación Práctica: Conexión Inicial de Canales

Para el lunes, selecciona al menos dos canales (ej. Discord y Telegram) que tu equipo use internamente. Crea los bots correspondientes en cada plataforma y obtén los tokens necesarios. Modifica el archivo `config.yaml` de tu agente OpenClaw para incluir los bloques de configuración de estos canales, utilizando los tokens obtenidos. Inicia el agente y verifica que se conecte correctamente a ambos canales, enviando un mensaje de prueba a cada uno. Esto validará la configuración y preparará el agente para interacciones reales. Asegúrate de que las credenciales no queden expuestas en sistemas de control de versiones públicos.