Grupos do Clawdbot
Configure o assistente de IA Clawdbot para chats em grupo. Aprenda sobre detecção de grupos, manipulação de mensagens, menções e conversas multiusuário.
Visão Geral dos Grupos do Clawdbot
O Clawdbot suporta conversas em grupo em todos os provedores de mensagens. Este guia cobre configuração de chat em grupo, roteamento de mensagens e padrões de interação multiusuário.
Detecção de Grupos
Detecção Automática
O Clawdbot detecta automaticamente chats em grupo:
| Provedor | Método de Detecção |
|---|---|
Sufixo do Chat ID @g.us | |
| Telegram | chat.type na atualização |
| Discord | Tipo de canal |
| ID da sala do grupo | |
| Feishu | Campo de tipo de chat |
Chaves de Sessão
Sessões de grupo usam chaves distintas:
agent:<agentId>:<channel>:group:<groupId>Configuração
Habilitar Suporte a Grupos
{
"providers": {
"whatsapp": {
"groups": {
"enabled": true,
"mentionOnly": true
}
}
}
}Configurações de Grupo
| Configuração | Padrão | Descrição |
|---|---|---|
enabled | true | Permitir mensagens de grupo |
mentionOnly | false | Responder apenas a menções |
allowList | [] | IDs de grupos permitidos |
denyList | [] | IDs de grupos bloqueados |
Tratamento de Menções
Detecção de Menções
O Clawdbot detecta menções:
{
"groups": {
"mentionPatterns": [
"@bot",
"@clawdbot",
"hey bot"
]
}
}Modos de Resposta
| Modo | Comportamento |
|---|---|
mention_only | Responder apenas quando mencionado |
all_messages | Responder a todas as mensagens |
smart | Usar contexto para decidir |
Roteamento de Mensagens
Grupo vs DM
| Atributo | DM | Grupo |
|---|---|---|
| Chave de sessão | agent:<id>:<main> | agent:<id>:<ch>:group:<gid> |
| Contexto | Privado | Compartilhado |
| Histórico | Por usuário | Por grupo |
Regras de Roteamento
{
"bindings": [
{
"agentId": "work",
"match": {
"channel": "whatsapp",
"peer": { "kind": "group", "id": "[email protected]" }
}
}
]
}Contexto Multiusuário
Identificação de Usuários
O Clawdbot rastreia usuários em grupos:
{
"message": {
"sender": {
"id": "user123",
"name": "John",
"role": "member"
},
"group": {
"id": "group456",
"name": "Team Chat"
}
}
}Estratégias de Contexto
| Estratégia | Descrição |
|---|---|
shared | Todos os usuários compartilham contexto |
per_user | Cada usuário tem contexto separado |
hybrid | Histórico compartilhado, memória por usuário |
Comandos de Grupo
Comandos Integrados
| Comando | Descrição |
|---|---|
/status | Status do bot no grupo |
/help | Comandos disponíveis |
/mute | Pausar respostas do bot |
/unmute | Retomar respostas do bot |
Comandos Personalizados
{
"groups": {
"commands": {
"prefix": "/",
"custom": [
{
"name": "report",
"action": "generate_report"
}
]
}
}
}Limitação de Taxa
Limites a Nível de Grupo
{
"groups": {
"rateLimit": {
"messagesPerMinute": 10,
"cooldownSeconds": 5
}
}
}Segurança
Controles de Administrador
- Apenas administradores podem configurar o bot
- Silenciar/ativar requer permissões
- Listas de permissão/bloqueio a nível de grupo
Privacidade
- Mensagens de grupo isoladas de DMs
- Sem compartilhamento de contexto entre grupos
- Respeitar configurações de privacidade do provedor
Próximos Passos
- Conceitos do Clawdbot - Conceitos principais
- Canais do Clawdbot - Configuração de canais
- Gateway do Clawdbot - Configuração do Gateway
Arquitetura do Clawdbot
Aprofunde-se na arquitetura do assistente de IA Clawdbot. Aprenda sobre o modelo Gateway-Agent, API WebSocket, fluxo de mensagens e design do sistema.
Streaming do Clawdbot
Aprenda sobre respostas em streaming do assistente de IA Clawdbot, chunking, indicadores de digitação e entrega de mensagens em tempo real.