Grupos de Clawdbot
Configura el asistente de IA Clawdbot para chats grupales. Aprende sobre detección de grupos, manejo de mensajes, menciones y conversaciones multiusuario.
Resumen de Grupos de Clawdbot
Clawdbot soporta conversaciones grupales en todos los proveedores de mensajería. Esta guía cubre la configuración de chat grupal, enrutamiento de mensajes y patrones de interacción multiusuario.
Detección de Grupos
Detección Automática
Clawdbot detecta automáticamente los chats grupales:
| Proveedor | Método de Detección |
|---|---|
Sufijo del Chat ID @g.us | |
| Telegram | chat.type en la actualización |
| Discord | Tipo de canal |
| ID de sala de grupo | |
| Feishu | Campo de tipo de chat |
Claves de Sesión
Las sesiones de grupo usan claves distintas:
agent:<agentId>:<channel>:group:<groupId>Configuración
Habilitar Soporte de Grupos
{
"providers": {
"whatsapp": {
"groups": {
"enabled": true,
"mentionOnly": true
}
}
}
}Ajustes de Grupo
| Ajuste | Por Defecto | Descripción |
|---|---|---|
enabled | true | Permitir mensajes de grupo |
mentionOnly | false | Solo responder a menciones |
allowList | [] | IDs de grupos permitidos |
denyList | [] | IDs de grupos bloqueados |
Manejo de Menciones
Detección de Menciones
Clawdbot detecta menciones:
{
"groups": {
"mentionPatterns": [
"@bot",
"@clawdbot",
"hey bot"
]
}
}Modos de Respuesta
| Modo | Comportamiento |
|---|---|
mention_only | Solo responder cuando se menciona |
all_messages | Responder a todos los mensajes |
smart | Usar contexto para decidir |
Enrutamiento de Mensajes
Grupo vs DM
| Atributo | DM | Grupo |
|---|---|---|
| Clave de sesión | agent:<id>:<main> | agent:<id>:<ch>:group:<gid> |
| Contexto | Privado | Compartido |
| Historial | Por usuario | Por grupo |
Reglas de Enrutamiento
{
"bindings": [
{
"agentId": "work",
"match": {
"channel": "whatsapp",
"peer": { "kind": "group", "id": "[email protected]" }
}
}
]
}Contexto Multiusuario
Identificación de Usuarios
Clawdbot rastrea usuarios en grupos:
{
"message": {
"sender": {
"id": "user123",
"name": "John",
"role": "member"
},
"group": {
"id": "group456",
"name": "Team Chat"
}
}
}Estrategias de Contexto
| Estrategia | Descripción |
|---|---|
shared | Todos los usuarios comparten contexto |
per_user | Cada usuario tiene contexto separado |
hybrid | Historial compartido, memoria por usuario |
Comandos de Grupo
Comandos Integrados
| Comando | Descripción |
|---|---|
/status | Estado del bot en el grupo |
/help | Comandos disponibles |
/mute | Pausar respuestas del bot |
/unmute | Reanudar respuestas del bot |
Comandos Personalizados
{
"groups": {
"commands": {
"prefix": "/",
"custom": [
{
"name": "report",
"action": "generate_report"
}
]
}
}
}Limitación de Velocidad
Límites a Nivel de Grupo
{
"groups": {
"rateLimit": {
"messagesPerMinute": 10,
"cooldownSeconds": 5
}
}
}Seguridad
Controles de Administrador
- Solo los administradores pueden configurar el bot
- Silenciar/activar requiere permisos
- Listas de permitidos/bloqueados a nivel de grupo
Privacidad
- Mensajes de grupo aislados de DMs
- Sin compartir contexto entre grupos
- Respetar configuraciones de privacidad del proveedor
Próximos Pasos
- Conceptos de Clawdbot - Conceptos principales
- Canales de Clawdbot - Configuración de canales
- Gateway de Clawdbot - Configuración del Gateway
Arquitectura de Clawdbot
Profundiza en la arquitectura del asistente de IA Clawdbot. Aprende sobre el modelo Gateway-Agent, la API WebSocket, el flujo de mensajes y el diseño del sistema.
Streaming de Clawdbot
Aprende sobre las respuestas en streaming del asistente de IA Clawdbot, chunking, indicadores de escritura y entrega de mensajes en tiempo real.