Configuracion del bot de Discord

Guia paso a paso para conectar tu agente de Claw Buff a Discord

Conecta tu agente de IA de Claw Buff a un servidor de Discord. Tu bot respondera a mensajes directos y mensajes en canales. La configuracion tarda unos 10 minutos.

Requisitos previos

Una cuenta de Discord
Un servidor de Discord donde tengas permisos de Gestionar servidor
Un agente de Claw Buff desplegado (Primeros pasos)

Paso 1: Crear una aplicacion de Discord

Abre el Portal de Desarrolladores

Ve al Portal de Desarrolladores de Discord y haz clic en New Application. Dale un nombre (por ejemplo, "Mi Agente IA").

Crea un bot

En la barra lateral, haz clic en Bot. Personaliza el nombre de usuario y el avatar del bot si lo deseas.

Habilita el Intent de Contenido de Mensajes

Desplazate hasta Privileged Gateway Intents y habilita:

Message Content Intent — Necesario para leer mensajes
Server Members Intent — Recomendado para acceso basado en roles

Haz clic en Save Changes.

Copia el Token del Bot

Haz clic en Reset Token (o Copy si se muestra) para obtener tu token de bot. Guardalo — lo necesitaras a continuacion.

Tu token de bot es un secreto. Nunca lo compartas publicamente. Si se ve comprometido, reinicialo inmediatamente en el Portal de Desarrolladores.

Paso 2: Invitar al bot a tu servidor

Genera un enlace de invitacion

En la barra lateral del Portal de Desarrolladores, haz clic en OAuth2 → URL Generator.

Selecciona estos scopes:

bot
applications.commands

Luego selecciona estos permisos de bot:

View Channels
Send Messages
Read Message History
Embed Links
Attach Files

Invita al bot

Copia la URL generada y abrela en tu navegador. Selecciona el servidor al que quieres agregar el bot y haz clic en Authorize.

Paso 3: Conectar a Claw Buff

Abre la Consola de Claw Buff → pagina de Canales
Encuentra la tarjeta de Discord y haz clic en Conectar
Pega tu Token de Bot del Paso 1
Haz clic en Guardar y activar

Tu bot estara en linea en segundos.

Paso 4: Empareja tu cuenta

Antes de que el bot responda, necesitas emparejar tu cuenta de Discord:

Envia un MD al bot — Haz clic en el nombre del bot en la lista de miembros del servidor y envia cualquier mensaje (por ejemplo, "hola")
El bot respondera con un codigo de emparejamiento (por ejemplo, X7QTGBD4)
Ve a la Consola de Claw Buff → pagina de Canales
Veras una seccion de Solicitudes de emparejamiento pendientes — haz clic en Aprobar junto al codigo

Una vez aprobado, el bot respondera a tus mensajes directos inmediatamente.

Paso 5: Habilitar canales del servidor (Opcional)

Por defecto, el bot solo funciona en mensajes directos. Para usarlo en canales del servidor:

En Discord, haz clic derecho en el icono de tu servidor → Copiar ID del servidor

Si no ves "Copiar ID del servidor", habilita primero el Modo desarrollador: Configuracion de usuario → Avanzado → activa el Modo desarrollador.

En la Consola, ve a Canales → haz clic en Gestionar en la tarjeta de Discord
En Servidores autorizados, pega tu ID de servidor y haz clic en Agregar

El bot ahora respondera a las @menciones en los canales de ese servidor. Puedes agregar multiples servidores.

Al mencionar al bot, asegurate de seleccionar el usuario del bot (que aparece en "Miembros" con la etiqueta APP), no el rol con el mismo nombre. Discord crea un rol con el mismo nombre que tu bot — mencionar el rol no activara una respuesta.

Caracteristicas

Caracteristica	Compatible
Mensajes directos	Si
Mensajes en canales	Si (requiere mencion)
Respuestas en streaming	Si (edicion en tiempo real)
Comandos de barra	Si
Embeds enriquecidos	Si
Archivos adjuntos	Si
Canales de voz	Si

Preguntas frecuentes

1. El bot aparece como desconectado en Discord?

Verifica el token — Asegurate de haber pegado el token completo
Verifica los intents — El Message Content Intent debe estar habilitado en el Portal de Desarrolladores
Verifica la Consola — La pagina de Canales muestra el estado de conexion y los registros de errores

2. El bot no responde a los mensajes?

Asegurate de que el Message Content Intent este habilitado (Paso 1)
En los canales, el bot requiere una @mencion para responder
Asegurate de mencionar al usuario del bot, no al rol — Al escribir @, selecciona el bot de la seccion "Miembros" (con la etiqueta APP), no de la seccion "Roles". Discord crea un rol con el mismo nombre que tu bot, pero mencionar el rol no activara una respuesta.
Verifica que el bot tenga permisos de View Channels y Read Message History en el canal

3. Error de "Missing Permissions"?

El bot necesita los permisos correctos en el canal. Verifica que tenga como minimo: View Channels, Send Messages, Read Message History y Embed Links.