Integración de Clawdbot con Discord

Descripción General de la Integración de Clawdbot con Discord

La integración de Clawdbot con Discord te permite llevar asistencia impulsada por IA a tus servidores de Discord usando la puerta de enlace oficial del bot de Discord. Está listo para mensajes directos y canales de texto de gremios.

¿Por Qué Usar Clawdbot con Discord?

Discord es la plataforma líder para gaming y comunicación comunitaria. Integrar Clawdbot con Discord ofrece:

Configuración Rápida (Principiante)

1. Crea un bot de Discord y copia el token del bot
2. En la configuración de la aplicación Discord, habilita Message Content Intent (y Server Members Intent si es necesario)
3. Configura el token vía env (DISCORD_BOT_TOKEN=...) o config (channels.discord.token)
4. Invita al bot a tu servidor con permisos de mensaje
5. Inicia la puerta de enlace
6. El acceso por DM es por emparejamiento por defecto; aprueba el código de emparejamiento en el primer contacto

Configuración mínima:

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

Configurando Clawdbot Discord

Requisitos Previos

Antes de conectar Clawdbot a Discord, asegúrate de tener:

• Clawdbot instalado en tu dispositivo
• Una cuenta de Discord
• Acceso al Portal de Desarrolladores de Discord
• Permisos de administrador del servidor

Paso 1: Crear una Aplicación de Discord

Configura tu aplicación Clawdbot Discord:

1. Ve al Portal de Desarrolladores de Discord
2. Haz clic en "New Application"
3. En tu aplicación: Bot → Add Bot
4. Copia el Token del Bot

Paso 2: Habilitar Intenciones de Gateway

Habilita las intenciones que Clawdbot necesita:

• Message Content Intent — Requerido para leer el contenido de los mensajes
• Server Members Intent — Requerido para listas permitidas o búsquedas de nombres

Paso 3: Generar URL de Invitación

Usa el Generador de URL OAuth2 en el Portal de Desarrolladores:

Permisos requeridos para Clawdbot Discord:

• Read Messages/View Channels
• Send Messages
• Embed Links
• Read Message History
• Add Reactions
• Use Slash Commands

Paso 4: Configurar Clawdbot Discord

Añade tu bot de Discord a Clawdbot:

Variable de entorno:

DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN

Archivo de configuración (~/.clawdbot/clawdbot.json):

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

Si tanto env como config están configurados, config tiene prioridad.

Paso 5: Iniciar la Puerta de Enlace

clawdbot gateway --port 18789

Discord se inicia automáticamente cuando hay un token disponible y channels.discord.enabled no es false.

Paso 6: Verificar Conexión

Verifica el estado de tu Clawdbot Discord:

clawdbot channels status discord

Cómo Funciona

• Los chats directos se colapsan en la sesión principal del agente (por defecto agent:main:main)
• Los canales de gremio permanecen aislados como agent:<agentId>:discord:channel:<channelId>
• Los DMs grupales se ignoran por defecto; habilita vía channels.discord.dm.groupEnabled
• El enrutamiento es determinista: las respuestas siempre vuelven al canal de origen

Características de Clawdbot Discord

Control de Acceso DM

Los chats directos son seguros por defecto vía channels.discord.dm.policy:

Ejemplo (lista permitida estricta):

{
  "channels": {
    "discord": {
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user:123456789"]
      }
    }
  }
}

Configuración de Canales de Gremio

Establece reglas por gremio o por canal:

{
  "channels": {
    "discord": {
      "guilds": {
        "<guild_id>": {
          "channels": ["bot-commands", "ai-chat"],
          "requireMention": true
        }
      }
    }
  }
}

Comandos Slash

Clawdbot Discord soporta comandos slash nativos:

Los comandos nativos por defecto son "auto" (activados para Discord/Telegram). Sobrescribe con:

{
  "channels": {
    "discord": {
      "commands": {
        "native": true
      }
    }
  }
}

Historial de Contexto del Gremio

Establece channels.discord.historyLimit (predeterminado 20) para incluir los últimos N mensajes del gremio como contexto al responder a una mención. Establece 0 para deshabilitar.

Reacciones

El agente puede activar reacciones vía la herramienta discord (controlada por channels.discord.actions.*).

Configuración de Clawdbot Discord

Ejemplo de Configuración Completa

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "groupEnabled": false
      },
      "guilds": {
        "*": {
          "requireMention": true
        }
      },
      "historyLimit": 20
    }
  }
}

Escrituras de Configuración

Por defecto, Discord permite escribir actualizaciones de configuración activadas por /config set|unset. Deshabilita con:

{
  "channels": {
    "discord": {
      "configWrites": false
    }
  }
}

Almacenamiento de Credenciales de Clawdbot Discord

Clawdbot almacena las credenciales de Discord de forma segura:

~/.clawdbot/credentials/discord/bot_token
~/.clawdbot/credentials/discord/servers.json

Tus datos de Clawdbot Discord permanecen en tu máquina local.

Solución de Problemas de Clawdbot Discord

Bot Desconectado

Si Clawdbot Discord aparece desconectado:

1. Verifica el token: clawdbot channels verify discord
2. Verifica la conexión de la puerta de enlace
3. Revisa los registros: cat /tmp/clawdbot/discord.log

Comandos Slash No Funcionan

Si los comandos slash de Clawdbot Discord fallan:

1. Vuelve a registrar los comandos vía configuración
2. Verifica los permisos del bot
3. Verifica el registro de comandos específicos del servidor

Errores de Permisos

Si Clawdbot Discord carece de permisos:

1. Revisa la posición del rol del bot en la configuración del servidor
2. Verifica los permisos específicos del canal
3. Vuelve a invitar con los permisos correctos

Resolución de Nombres

La resolución nombre → id usa búsqueda de miembros del gremio y requiere Server Members Intent. Si el bot no puede buscar miembros, usa ids o menciones <@id>.

Mejores Prácticas de Clawdbot Discord

1. Usa el Modo de Emparejamiento: Seguro por defecto con códigos de emparejamiento para DMs
2. Establece Límites de Canal: Restringe Clawdbot Discord a canales apropiados
3. Configura Roles: Usa acceso basado en roles para Clawdbot Discord
4. Monitorea la Actividad: Revisa los registros de Clawdbot Discord regularmente
5. Usa Comandos Slash: Mejor UX que los comandos de texto

Casos de Uso de Clawdbot Discord

Soporte Comunitario

Despliega Clawdbot Discord como un bot de soporte:

• Responde FAQs automáticamente
• Escala problemas complejos
• Proporciona asistencia 24/7

Comunidades de Gaming

Usa Clawdbot Discord para servidores de gaming:

• Búsqueda de información de juegos
• Coordinación de equipos
• Programación de eventos

Comunidades de Desarrolladores

Clawdbot Discord para servidores de desarrolladores:

• Asistencia con código
• Búsqueda de documentación
• Triaje de bugs

Próximos Pasos

• Integración de Clawdbot con WhatsApp - Conecta Clawdbot a WhatsApp
• Integración de Clawdbot con Telegram - Configura Clawdbot en Telegram
• Guía de Configuración de Clawdbot - Guía de instalación completa