Actividades de Discord

Las Actividades de Discord permiten que un agente publique un widget HTML interactivo y autónomo en el canal de Discord actual. El mensaje incluye un botón Open widget; al hacer clic, el widget se abre dentro de Discord.

La función está desactivada de forma predeterminada. OpenClaw registra las rutas HTTP de la Actividad, la herramienta del agente show_widget y el controlador del botón de apertura solo cuando channels.discord.activities está presente y se puede resolver un secreto de cliente. El alias obsoleto discord_widget seguirá disponible durante una versión.

Requisitos previos

• un bot de Discord de OpenClaw existente
• un nombre de host HTTPS público que llegue al Gateway de OpenClaw
• permiso para configurar Actividades y OAuth2 para la aplicación de Discord del bot

Cualquier proxy inverso o túnel HTTPS sirve. Un túnel de Cloudflare con nombre proporciona un nombre de host estable sin exponer directamente el puerto del Gateway.

# ~/.cloudflared/config.ymltunnel: openclaw-discordcredentials-file: /home/you/.cloudflared/TUNNEL-ID.jsoningress:  - hostname: openclaw.example.com    service: http://127.0.0.1:18789  - service: http_status:404

cloudflared tunnel logincloudflared tunnel create openclaw-discordcloudflared tunnel route dns openclaw-discord openclaw.example.comcloudflared tunnel run openclaw-discord

Mantenga habilitada la autenticación normal del Gateway. Solo el prefijo de la Actividad es público, y el propio plugin valida OAuth, la pertenencia a la instancia de la Actividad, la vinculación del canal, las sesiones y las capacidades de documento de un solo uso.

Configuración

{  channels: {    discord: {      token: "${DISCORD_BOT_TOKEN}",      activities: {        clientSecret: "${DISCORD_CLIENT_SECRET}",        // Opcional. El valor predeterminado es el ID de la aplicación del bot obtenido al iniciar.        applicationId: "YOUR_DISCORD_APPLICATION_ID",      },    },  },}

Modelo de seguridad

• OAuth identifica al usuario de Discord antes de devolver los metadatos del widget.
• La API Get Activity Instance de Discord debe confirmar que el usuario de OAuth está presente en la instancia actual de la Actividad. El canal de la instancia debe coincidir con el canal donde se publicó el widget.
• Todas las personas a las que Discord permita acceder a ese canal pueden abrir sus widgets. Para limitar la audiencia, utilice los permisos de canal de Discord. Las listas de permitidos de comandos y mensajes directos de OpenClaw no conceden ni revocan el acceso al contenido ya publicado en el canal.
• Las sesiones de OAuth caducan después de 15 minutos. Las capacidades de documento del widget caducan después de 60 segundos y funcionan una sola vez.
• Los widgets caducan después de siete días y se conservan como máximo 64 por instancia del plugin de Discord.
• El HTML del widget lo crea el agente y debe tratarse como contenido de confianza. No incluya secretos que no querría que un widget defectuoso expusiera.
• El widget puede navegar dentro de su propio marco anidado. El iframe sandbox="allow-scripts" bloquea la navegación de nivel superior, las ventanas emergentes y el acceso al mismo origen, mientras que su Política de seguridad de contenido bloquea las conexiones de red y los recursos externos. Estos controles constituyen una defensa en profundidad, no un límite de seguridad frente al agente que creó el widget.
• Cuando las Actividades están deshabilitadas, /discord/activity no se registra en absoluto.

El contenedor público de la Actividad y la ruta de intercambio de tokens pasan a ser accesibles a través del túnel cuando se habilitan. No exponen el HTML del widget sin una sesión de OAuth válida y una capacidad de documento de un solo uso.

Solución de problemas

La Actividad indica “Gateway offline”

• confirme que el túnel está en ejecución y dirige el tráfico al puerto de enlace real del Gateway
• confirme que el destino del Portal para desarrolladores incluye /discord/activity
• reinicie el Gateway después de cambiar la configuración de Discord u OpenClaw
• revise los registros del Gateway para detectar la advertencia de una línea sobre la ausencia del secreto de cliente de Actividades

Discord abre una página en blanco o informa de blocked:csp

• compruebe que la asignación de URL utiliza ROOT y no añade un segundo segmento /discord/activity
• confirme que el contenedor, shell.js y el módulo del SDK se devuelven correctamente a través del proxy de Discord
• inspeccione los registros del Gateway para buscar solicitudes bajo /discord/activity/

Las solicitudes de red de los widgets se bloquean intencionadamente. Incluya en línea todo el CSS, JavaScript, las imágenes y los datos que necesite el widget.

“Widget unavailable”

Abra el botón desde el canal donde el agente lo publicó. OpenClaw registra las aperturas en el servidor cuando se hace clic, por lo que un registro de apertura reciente puede resolver el widget exacto incluso cuando Discord omite o altera el ID personalizado del botón. Cuando ni el ID personalizado ni un registro de apertura permiten resolverlo, OpenClaw abre el widget activo publicado más recientemente en ese canal. Los widgets anteriores siguen siendo accesibles mediante los botones que conservan su ID personalizado.

“You cannot launch Activities in this channel”

Discord no abre Actividades desde hilos de publicaciones de foros. OpenClaw puede publicar allí el mensaje y el botón del widget, pero la Actividad debe abrirse desde un canal de texto normal. Esta restricción procede de Discord, no de OpenClaw.