Clawdbot Gruppen

Konfigurieren Sie den Clawdbot KI-Assistenten für Gruppenchats. Erfahren Sie mehr über Gruppenerkennung, Nachrichtenverarbeitung, Erwähnungen und Mehrbenutzer-Konversationen.

Clawdbot Gruppen Überblick

Clawdbot unterstützt Gruppenkonversationen bei allen Messaging-Anbietern. Dieser Leitfaden behandelt die Gruppenchat-Konfiguration, Nachrichtenrouting und Mehrbenutzer-Interaktionsmuster.

Gruppenerkennung

Automatische Erkennung

Clawdbot erkennt Gruppenchats automatisch:

AnbieterErkennungsmethode
WhatsAppChat-ID-Suffix @g.us
Telegramchat.type im Update
DiscordKanaltyp
WeChatGruppenraum-ID
FeishuChat-Typ-Feld

Sitzungsschlüssel

Gruppensitzungen verwenden separate Schlüssel:

agent:<agentId>:<channel>:group:<groupId>

Konfiguration

Gruppenunterstützung aktivieren

{
  "providers": {
    "whatsapp": {
      "groups": {
        "enabled": true,
        "mentionOnly": true
      }
    }
  }
}

Gruppeneinstellungen

EinstellungStandardBeschreibung
enabledtrueGruppennachrichten erlauben
mentionOnlyfalseNur auf Erwähnungen antworten
allowList[]Erlaubte Gruppen-IDs
denyList[]Blockierte Gruppen-IDs

Erwähnungsverarbeitung

Erwähnungserkennung

Clawdbot erkennt Erwähnungen:

{
  "groups": {
    "mentionPatterns": [
      "@bot",
      "@clawdbot",
      "hey bot"
    ]
  }
}

Antwortmodi

ModusVerhalten
mention_onlyNur bei Erwähnung antworten
all_messagesAuf alle Nachrichten antworten
smartKontext zur Entscheidung nutzen

Nachrichtenrouting

Gruppe vs DM

AttributDMGruppe
Sitzungsschlüsselagent:<id>:<main>agent:<id>:<ch>:group:<gid>
KontextPrivatGeteilt
VerlaufPro BenutzerPro Gruppe

Routing-Regeln

{
  "bindings": [
    {
      "agentId": "work",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "group", "id": "[email protected]" }
      }
    }
  ]
}

Mehrbenutzer-Kontext

Benutzeridentifikation

Clawdbot verfolgt Benutzer in Gruppen:

{
  "message": {
    "sender": {
      "id": "user123",
      "name": "John",
      "role": "member"
    },
    "group": {
      "id": "group456",
      "name": "Team Chat"
    }
  }
}

Kontextstrategien

StrategieBeschreibung
sharedAlle Benutzer teilen Kontext
per_userJeder Benutzer hat separaten Kontext
hybridGeteilter Verlauf, Speicher pro Benutzer

Gruppenbefehle

Integrierte Befehle

BefehlBeschreibung
/statusBot-Status in der Gruppe
/helpVerfügbare Befehle
/muteBot-Antworten pausieren
/unmuteBot-Antworten fortsetzen

Benutzerdefinierte Befehle

{
  "groups": {
    "commands": {
      "prefix": "/",
      "custom": [
        {
          "name": "report",
          "action": "generate_report"
        }
      ]
    }
  }
}

Ratenbegrenzung

Limits auf Gruppenebene

{
  "groups": {
    "rateLimit": {
      "messagesPerMinute": 10,
      "cooldownSeconds": 5
    }
  }
}

Sicherheit

Administrator-Kontrollen

  • Nur Administratoren können den Bot konfigurieren
  • Stummschalten/Aufheben erfordert Berechtigungen
  • Erlaubnis-/Sperrlisten auf Gruppenebene

Datenschutz

  • Gruppennachrichten von DMs isoliert
  • Kein Kontextaustausch zwischen Gruppen
  • Datenschutzeinstellungen des Anbieters respektieren

Nächste Schritte