Actividades de Discord

Las Activities de Discord permiten que un agente publique un widget HTML interactivo y autónomo en el canal actual de Discord. 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 Activity, la herramienta de 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 OpenClaw para Discord existente
• un nombre de host HTTPS público que permita acceder al Gateway de OpenClaw
• permiso para configurar Activities y OAuth2 para la aplicación de Discord del bot

Se puede usar cualquier proxy inverso o túnel HTTPS. Un Cloudflare Tunnel 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 Activity es público, y el propio plugin valida OAuth, la pertenencia a la instancia de Activity, 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 durante el inicio.        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 Activity. 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 restringir el público, utilice los permisos del canal de Discord. Las listas de permitidos de comandos y mensajes directos de OpenClaw no conceden ni eliminan 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 con errores 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 una barrera de seguridad frente al agente que creó el widget.
• Cuando Activities está deshabilitado, /discord/activity no se registra en absoluto.

El contenedor público de Activity 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

Activity indica “Gateway offline”

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

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

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

Las solicitudes de red de los widgets se bloquean de forma intencionada. 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 realiza un seguimiento de 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 botones que conserven su ID personalizado.

“You cannot launch Activities in this channel”

Discord no permite iniciar Activities desde hilos de publicaciones de foros. OpenClaw puede publicar allí el mensaje y el botón del widget, pero Activity debe iniciarse desde un canal de texto normal. Esta restricción procede de Discord, no de OpenClaw.