Skill Discord para OpenClaw

Descripción General del Skill Discord de OpenClaw

El skill Discord conecta OpenClaw a tus servidores de Discord a través de la Discord API, convirtiendo tu agente de IA en un potente asistente de Discord. Una vez instalado, puedes enviar mensajes, gestionar hilos, crear encuestas, subir emojis e incluso manejar la moderación — todo mediante comandos en lenguaje natural.

Discord es una de las plataformas más populares para comunidades de desarrolladores, proyectos de código abierto y comunicación en equipo. El skill Discord de OpenClaw elimina la necesidad de cambiar de contexto entre tu terminal y Discord. Ya sea que estés monitoreando canales de la comunidad, respondiendo preguntas o gestionando configuraciones del servidor, una simple conversación con OpenClaw se encarga de todo.

Flujo de trabajo típico:

1. Pide a OpenClaw que envíe un mensaje o consulte la actividad reciente en un canal de Discord.
2. El agente llama a la Discord API con la acción apropiada (por ejemplo, sendMessage, readMessages).
3. Los resultados se devuelven en un resumen legible — sin necesidad de cambiar de contexto.

Requisitos Previos del Skill Discord

Antes de instalar el skill Discord, asegúrate de tener:

• OpenClaw instalado y en ejecución (v1.0+)
• Una cuenta de Discord con acceso a los servidores que deseas gestionar
• Un bot de Discord creado en el Developer Portal con un token de bot
• El bot invitado a tu servidor con los permisos necesarios
• clawhub CLI instalado para la gestión de skills

Verifica tu configuración:

# Comprobar la versión de OpenClaw
openclaw --version

# Comprobar clawhub CLI
clawhub --version

Crear un Bot de Discord

Si aún no tienes un bot, sigue estos pasos:

1. Ve al Discord Developer Portal y haz clic en New Application.
2. Navega a la pestaña Bot y haz clic en Add Bot.
3. Copia el token del bot — lo necesitarás para la configuración.
4. En Privileged Gateway Intents, habilita Message Content Intent si necesitas que el skill lea el contenido de los mensajes.
5. Usa el OAuth2 URL Generator para crear un enlace de invitación con el alcance bot y los permisos que necesites.

Cómo Instalar el Skill Discord

Instala el skill Discord con un solo comando:

npx clawhub@latest install discord

Para verificar la instalación:

clawhub list

Deberías ver discord en la lista de skills instalados. También puedes previsualizar el skill antes de instalarlo con clawhub inspect discord.

Configuración del Skill Discord

El skill Discord requiere un token de bot para la autenticación. Crea un bot en el Discord Developer Portal si aún no lo has hecho.

Configuración del Entorno

# Establecer tu token de bot de Discord
export DISCORD_BOT_TOKEN=your_bot_token_here

Importante: Nunca escribas tokens directamente en archivos de configuración. Usa variables de entorno o un gestor de secretos como 1Password.

Gateway Intents

El skill utiliza Discord Gateway Intents para recibir eventos. Tres intents son privilegiados y deben habilitarse en el Developer Portal:

| Intent | Propósito | ¿Requerido? | |--------|-----------|-------------| | MESSAGE_CONTENT | Leer texto de mensajes, embeds y archivos adjuntos | Sí, para readMessages | | GUILD_MEMBERS | Acceder a eventos de entrada/salida de miembros y listas de miembros | Solo si se usa memberInfo | | GUILD_PRESENCES | Rastrear el estado en línea/desconectado de usuarios | Raramente necesario |

Habilita solo los intents que tu caso de uso requiera. Para la mayoría de las configuraciones, MESSAGE_CONTENT por sí solo es suficiente.

Control de Acciones

El skill Discord soporta un control granular de acciones. La mayoría de las acciones están habilitadas por defecto, pero las acciones sensibles están deshabilitadas:

| Acción | Por Defecto | Descripción | |--------|-------------|-------------| | discord.actions.moderation | false | Silenciar, expulsar y banear usuarios | | discord.actions.roles | false | Agregar o eliminar roles de miembros |

Para habilitar las acciones de moderación, actualiza tu configuración de OpenClaw:

# Habilitar acciones de moderación (usar con precaución)
openclaw config set discord.actions.moderation true

Ejemplos de Uso del Skill Discord

1. Enviar un Mensaje a un Canal

Tú: "Envía un mensaje al canal #announcements diciendo 'La versión 2.0 ya está disponible. Consulta las notas de la versión para más detalles.'"

El agente utiliza la acción sendMessage con el ID del canal de destino. Publica el mensaje y confirma la entrega con el enlace al mensaje.

2. Monitorear Preguntas de la Comunidad

Tú: "Lee los últimos 10 mensajes en #help-forum y resume las preguntas sin responder."

El agente llama a readMessages en el canal especificado, filtra los mensajes sin respuestas y devuelve un resumen de las preguntas sin responder con enlaces a cada hilo.

3. Crear una Encuesta en la Comunidad

Tú: "Crea una encuesta en #general preguntando '¿Qué función deberíamos desarrollar a continuación?' con las opciones: Modo oscuro, App móvil, Mejoras en la API, Mejor documentación. Que dure 24 horas."

El agente crea una encuesta usando la acción poll con hasta 10 opciones de respuesta. Establece la duración y devuelve una confirmación con el enlace de la encuesta.

4. Subir un Emoji Personalizado

Tú: "Sube esta imagen como un emoji personalizado llamado 'ship_it' a nuestro servidor."

El agente usa emojiUpload para agregar la imagen (PNG/JPG/GIF, máximo 256KB) como emoji del servidor. Confirma la subida y muestra el código del emoji :ship_it: para usar en mensajes.

Seguridad y Mejores Prácticas

El skill Discord puede realizar operaciones de escritura en tus servidores, incluyendo el envío de mensajes y — si están habilitadas — acciones de moderación. Sigue estas directrices para mantenerte seguro:

• Usa el mínimo privilegio. Solo otorga al bot los permisos que realmente necesita. Evita conceder el permiso Administrator a menos que sea absolutamente necesario.
• Mantén la moderación deshabilitada por defecto. El skill deshabilita las acciones de moderation y roles de fábrica. Solo habilítalas si tienes una necesidad específica y comprendes las implicaciones.
• Habilita solo los intents requeridos. Los intents privilegiados como MESSAGE_CONTENT y GUILD_MEMBERS solo deben habilitarse cuando tu flujo de trabajo depende de ellos.
• Rota tu token de bot regularmente. Si sospechas que un token ha sido comprometido, regenera uno inmediatamente en el Developer Portal.
• Revisa antes de confirmar. OpenClaw solicita confirmación en acciones destructivas. Siempre lee el resumen de la acción antes de aprobar, especialmente para moderación y operaciones masivas.
• Audita la actividad del bot. Usa el Registro de Auditoría de Discord para rastrear las acciones realizadas por tu bot y verificar que coincidan con tus expectativas.

Solución de Errores Comunes

"401: Unauthorized"

Tu token de bot falta, es inválido o ha sido regenerado.

1. Verifica que DISCORD_BOT_TOKEN esté configurado en tu entorno.
2. Comprueba que el token coincida con el que aparece en la configuración del bot en tu Developer Portal.
3. Si el token fue regenerado recientemente, actualiza tu variable de entorno.

# Verificar que el token esté configurado
echo $DISCORD_BOT_TOKEN

"50001: Missing Access"

El bot no tiene permiso para acceder al canal o servidor de destino.

1. Confirma que el bot ha sido invitado al servidor con los permisos correctos.
2. Verifica las anulaciones de permisos a nivel de canal que podrían bloquear al bot.
3. Usa la acción permissions para comprobar los permisos efectivos del bot en un canal.

"MESSAGE_CONTENT intent is required"

Estás intentando leer el contenido de mensajes pero el intent privilegiado MESSAGE_CONTENT no está habilitado.

1. Ve al Developer Portal → tu aplicación → pestaña Bot.
2. En Privileged Gateway Intents, habilita Message Content Intent.
3. Para bots verificados (75+ servidores), debes solicitar este intent a través del portal.