Groupes Clawdbot
Configurez l'assistant IA Clawdbot pour les chats de groupe. Apprenez la détection des groupes, la gestion des messages, les mentions et les conversations multi-utilisateurs.
Aperçu des Groupes Clawdbot
Clawdbot prend en charge les conversations de groupe sur tous les fournisseurs de messagerie. Ce guide couvre la configuration des chats de groupe, le routage des messages et les modèles d'interaction multi-utilisateurs.
Détection des Groupes
Détection Automatique
Clawdbot détecte automatiquement les chats de groupe :
| Fournisseur | Méthode de Détection |
|---|---|
Suffixe de l'ID de chat @g.us | |
| Telegram | chat.type dans la mise à jour |
| Discord | Type de canal |
| ID de salle de groupe | |
| Feishu | Champ de type de chat |
Clés de Session
Les sessions de groupe utilisent des clés distinctes :
agent:<agentId>:<channel>:group:<groupId>Configuration
Activer le Support des Groupes
{
"providers": {
"whatsapp": {
"groups": {
"enabled": true,
"mentionOnly": true
}
}
}
}Paramètres de Groupe
| Paramètre | Par Défaut | Description |
|---|---|---|
enabled | true | Autoriser les messages de groupe |
mentionOnly | false | Répondre uniquement aux mentions |
allowList | [] | IDs de groupes autorisés |
denyList | [] | IDs de groupes bloqués |
Gestion des Mentions
Détection des Mentions
Clawdbot détecte les mentions :
{
"groups": {
"mentionPatterns": [
"@bot",
"@clawdbot",
"hey bot"
]
}
}Modes de Réponse
| Mode | Comportement |
|---|---|
mention_only | Répondre uniquement quand mentionné |
all_messages | Répondre à tous les messages |
smart | Utiliser le contexte pour décider |
Routage des Messages
Groupe vs DM
| Attribut | DM | Groupe |
|---|---|---|
| Clé de session | agent:<id>:<main> | agent:<id>:<ch>:group:<gid> |
| Contexte | Privé | Partagé |
| Historique | Par utilisateur | Par groupe |
Règles de Routage
{
"bindings": [
{
"agentId": "work",
"match": {
"channel": "whatsapp",
"peer": { "kind": "group", "id": "[email protected]" }
}
}
]
}Contexte Multi-Utilisateur
Identification des Utilisateurs
Clawdbot suit les utilisateurs dans les groupes :
{
"message": {
"sender": {
"id": "user123",
"name": "John",
"role": "member"
},
"group": {
"id": "group456",
"name": "Team Chat"
}
}
}Stratégies de Contexte
| Stratégie | Description |
|---|---|
shared | Tous les utilisateurs partagent le contexte |
per_user | Chaque utilisateur a un contexte séparé |
hybrid | Historique partagé, mémoire par utilisateur |
Commandes de Groupe
Commandes Intégrées
| Commande | Description |
|---|---|
/status | Statut du bot dans le groupe |
/help | Commandes disponibles |
/mute | Mettre en pause les réponses du bot |
/unmute | Reprendre les réponses du bot |
Commandes Personnalisées
{
"groups": {
"commands": {
"prefix": "/",
"custom": [
{
"name": "report",
"action": "generate_report"
}
]
}
}
}Limitation de Débit
Limites au Niveau du Groupe
{
"groups": {
"rateLimit": {
"messagesPerMinute": 10,
"cooldownSeconds": 5
}
}
}Sécurité
Contrôles Administrateur
- Seuls les administrateurs peuvent configurer le bot
- Couper/rétablir le son nécessite des permissions
- Listes d'autorisation/blocage au niveau du groupe
Confidentialité
- Messages de groupe isolés des DMs
- Pas de partage de contexte entre groupes
- Respecter les paramètres de confidentialité du fournisseur
Prochaines Étapes
- Concepts Clawdbot - Concepts fondamentaux
- Canaux Clawdbot - Configuration des canaux
- Gateway Clawdbot - Configuration du Gateway
Architecture de Clawdbot
Plongez dans l'architecture de l'assistant IA Clawdbot. Découvrez le modèle Gateway-Agent, l'API WebSocket, le flux de messages et la conception du système.
Streaming Clawdbot
Découvrez les réponses en streaming de l'assistant IA Clawdbot, le chunking, les indicateurs de saisie et la livraison de messages en temps réel.