> ## Documentation Index > Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt > Use this file to discover all available pages before exploring further. # „Gruppen“ # Gruppen OpenClaw behandelt Gruppenchats über Oberflächen hinweg konsistent: WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams. ## Einsteiger-Einführung (2 Minuten) OpenClaw „lebt“ auf Ihren eigenen Messaging-Konten. Es gibt keinen separaten WhatsApp-Bot-Benutzer. Wenn **Sie** in einer Gruppe sind, kann OpenClaw diese Gruppe sehen und dort antworten. Standardverhalten: * Gruppen sind eingeschränkt (`groupPolicy: "allowlist"`). * Antworten erfordern eine Erwähnung, sofern Sie das Mention-Gating nicht explizit deaktivieren. Übersetzung: Allowlist-Absender können OpenClaw durch eine Erwähnung auslösen. > TL;DR > > * **DM-Zugriff** wird durch `*.allowFrom` gesteuert. > * **Gruppenzugriff** wird durch `*.groupPolicy` + Allowlists (`*.groups`, `*.groupAllowFrom`) gesteuert. > * **Auslösen von Antworten** wird durch Mention-Gating (`requireMention`, `/activation`) gesteuert. Schneller Ablauf (was mit einer Gruppennachricht passiert): ``` groupPolicy? disabled -> drop groupPolicy? allowlist -> group allowed? no -> drop requireMention? yes -> mentioned? no -> store for context only otherwise -> reply ``` Ablauf von Gruppennachrichten Wenn Sie möchten … | Ziel | Einstellung | | ------------------------------------------------------- | ---------------------------------------------------------- | | Alle Gruppen zulassen, aber nur auf @mentions antworten | `groups: { "*": { requireMention: true } }` | | Alle Gruppenantworten deaktivieren | `groupPolicy: "disabled"` | | Nur bestimmte Gruppen | `groups: { "": { ... } }` (kein `"*"`-Schlüssel) | | Nur Sie können in Gruppen auslösen | `groupPolicy: "allowlist"`, `groupAllowFrom: ["+1555..."]` | ## Sitzungsschlüssel * Gruppensitzungen verwenden `agent:::group:`-Sitzungsschlüssel (Räume/Kanäle verwenden `agent:::channel:`). * Telegram-Forenthemen fügen `:topic:` zur Gruppen-ID hinzu, sodass jedes Thema eine eigene Sitzung hat. * Direktchats verwenden die Hauptsitzung (oder pro Absender, falls konfiguriert). * Heartbeats werden für Gruppensitzungen übersprungen. ## Muster: persönliche DMs + öffentliche Gruppen (einzelner Agent) Ja — das funktioniert gut, wenn Ihr „persönlicher“ Verkehr **DMs** und Ihr „öffentlicher“ Verkehr **Gruppen** sind. Warum: Im Einzelagentenmodus landen DMs typischerweise in der **Haupt**-Sitzung (`agent:main:main`), während Gruppen immer **nicht-Haupt**-Sitzungsschlüssel (`agent:main::group:`) verwenden. Wenn Sie sandboxing mit `mode: "non-main"` aktivieren, laufen diese Gruppensitzungen in Docker, während Ihre Haupt-DM-Sitzung auf dem Host bleibt. Das ergibt ein Agenten-„Gehirn“ (gemeinsamer Arbeitsbereich + Speicher), aber zwei Ausführungsmodi: * **DMs**: vollständige Werkzeuge (Host) * **Gruppen**: sandbox + eingeschränkte Werkzeuge (Docker) > Wenn Sie wirklich getrennte Arbeitsbereiche/Personas benötigen („persönlich“ und „öffentlich“ dürfen sich niemals mischen), verwenden Sie einen zweiten Agenten + Bindings. Siehe [Multi-Agent Routing](/concepts/multi-agent). Beispiel (DMs auf dem Host, Gruppen sandboxed + nur Messaging-Werkzeuge): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { sandbox: { mode: "non-main", // groups/channels are non-main -> sandboxed scope: "session", // strongest isolation (one container per group/channel) workspaceAccess: "none", }, }, }, tools: { sandbox: { tools: { // If allow is non-empty, everything else is blocked (deny still wins). allow: ["group:messaging", "group:sessions"], deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"], }, }, }, } ``` Möchten Sie „Gruppen können nur Ordner X sehen“ statt „kein Host-Zugriff“? Behalten Sie `workspaceAccess: "none"` bei und mounten Sie nur allowlistete Pfade in die Sandbox: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { sandbox: { mode: "non-main", scope: "session", workspaceAccess: "none", docker: { binds: [ // hostPath:containerPath:mode "~/FriendsShared:/data:ro", ], }, }, }, }, } ``` Verwandt: * Konfigurationsschlüssel und Standardwerte: [Gateway-Konfiguration](/gateway/configuration#agentsdefaultssandbox) * Debugging, warum ein Werkzeug blockiert ist: [Sandbox vs Tool Policy vs Elevated](/gateway/sandbox-vs-tool-policy-vs-elevated) * Details zu Bind-Mounts: [Sandboxing](/gateway/sandboxing#custom-bind-mounts) ## Anzeige-Labels * UI-Labels verwenden `displayName`, wenn verfügbar, formatiert als `:`. * `#room` ist für Räume/Kanäle reserviert; Gruppenchats verwenden `g-` (kleingeschrieben, Leerzeichen -> `-`, `#@+._-` beibehalten). ## Gruppenrichtlinie Steuern Sie, wie Gruppen-/Raumnachrichten pro Kanal behandelt werden: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { groupPolicy: "disabled", // "open" | "disabled" | "allowlist" groupAllowFrom: ["+15551234567"], }, telegram: { groupPolicy: "disabled", groupAllowFrom: ["123456789", "@username"], }, signal: { groupPolicy: "disabled", groupAllowFrom: ["+15551234567"], }, imessage: { groupPolicy: "disabled", groupAllowFrom: ["chat_id:123"], }, msteams: { groupPolicy: "disabled", groupAllowFrom: ["user@org.com"], }, discord: { groupPolicy: "allowlist", guilds: { GUILD_ID: { channels: { help: { allow: true } } }, }, }, slack: { groupPolicy: "allowlist", channels: { "#general": { allow: true } }, }, matrix: { groupPolicy: "allowlist", groupAllowFrom: ["@owner:example.org"], groups: { "!roomId:example.org": { allow: true }, "#alias:example.org": { allow: true }, }, }, }, } ``` | Richtlinien | Verhalten | | ------------- | ------------------------------------------------------------------------- | | `"open"` | Gruppen umgehen Allowlists; Mention-Gating gilt weiterhin. | | `"disabled"` | Alle Gruppennachrichten vollständig blockieren. | | `"allowlist"` | Nur Gruppen/Räume zulassen, die der konfigurierten Allowlist entsprechen. | Hinweise: * `groupPolicy` ist getrennt vom Mention-Gating (das @mentions erfordert). * WhatsApp/Telegram/Signal/iMessage/Microsoft Teams: verwenden Sie `groupAllowFrom` (Fallback: explizites `allowFrom`). * Discord: Allowlist verwendet `channels.discord.guilds..channels`. * Slack: Allowlist verwendet `channels.slack.channels`. * Matrix: Allowlist verwendet `channels.matrix.groups` (Raum-IDs, Aliase oder Namen). Verwenden Sie `channels.matrix.groupAllowFrom`, um Absender einzuschränken; per-Raum-`users`-Allowlists werden ebenfalls unterstützt. * Gruppen-DMs werden separat gesteuert (`channels.discord.dm.*`, `channels.slack.dm.*`). * Die Telegram-Allowlist kann Benutzer-IDs (`"123456789"`, `"telegram:123456789"`, `"tg:123456789"`) oder Benutzernamen (`"@alice"` oder `"alice"`) abgleichen; Präfixe sind nicht case-sensitiv. * Standard ist `groupPolicy: "allowlist"`; ist Ihre Gruppen-Allowlist leer, werden Gruppennachrichten blockiert. Schnelles mentales Modell (Auswertungsreihenfolge für Gruppennachrichten): 1. `groupPolicy` (offen/deaktiviert/Allowlist) 2. Gruppen-Allowlists (`*.groups`, `*.groupAllowFrom`, kanalspezifische Allowlist) 3. Mention-Gating (`requireMention`, `/activation`) ## Mention-Gating (Standard) Gruppennachrichten erfordern eine Erwähnung, sofern sie nicht pro Gruppe überschrieben wird. Standardwerte liegen pro Subsystem unter `*.groups."*"`. Das Antworten auf eine Bot-Nachricht zählt als implizite Erwähnung (wenn der Kanal Reply-Metadaten unterstützt). Dies gilt für Telegram, WhatsApp, Slack, Discord und Microsoft Teams. ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { groups: { "*": { requireMention: true }, "123@g.us": { requireMention: false }, }, }, telegram: { groups: { "*": { requireMention: true }, "123456789": { requireMention: false }, }, }, imessage: { groups: { "*": { requireMention: true }, "123": { requireMention: false }, }, }, }, agents: { list: [ { id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"], historyLimit: 50, }, }, ], }, } ``` Hinweise: * `mentionPatterns` sind nicht case-sensitive Regexe. * Oberflächen, die explizite Erwähnungen bereitstellen, werden weiterhin durchgelassen; Muster sind ein Fallback. * Pro-Agent-Override: `agents.list[].groupChat.mentionPatterns` (nützlich, wenn mehrere Agenten eine Gruppe teilen). * Mention-Gating wird nur erzwungen, wenn die Erwähnungserkennung möglich ist (native Erwähnungen oder `mentionPatterns` sind konfiguriert). * Discord-Standardwerte liegen in `channels.discord.guilds."*"` (pro Guild/Kanal überschreibbar). * Der Gruppenverlaufs-Kontext wird kanalübergreifend einheitlich verpackt und ist **nur ausstehend** (Nachrichten, die aufgrund von Mention-Gating übersprungen wurden); verwenden Sie `messages.groupChat.historyLimit` für den globalen Standard und `channels..historyLimit` (oder `channels..accounts.*.historyLimit`) für Überschreibungen. Setzen Sie `0`, um zu deaktivieren. ## Gruppen-/Kanal-Werkzeugbeschränkungen (optional) Einige Kanalkonfigurationen unterstützen die Einschränkung, welche Werkzeuge **innerhalb einer bestimmten Gruppe/eines Raums/eines Kanals** verfügbar sind. * `tools`: Werkzeuge für die gesamte Gruppe erlauben/verbieten. * `toolsBySender`: Pro-Absender-Overrides innerhalb der Gruppe (Schlüssel sind Absender-IDs/Benutzernamen/E-Mails/Telefonnummern je nach Kanal). Verwenden Sie `"*"` als Platzhalter. Auflösungsreihenfolge (das Spezifischste gewinnt): 1. Gruppen-/Kanal-`toolsBySender`-Match 2. Gruppen-/Kanal-`tools` 3. Standard (`"*"`) `toolsBySender`-Match 4. Standard (`"*"`) `tools` Beispiel (Telegram): ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { telegram: { groups: { "*": { tools: { deny: ["exec"] } }, "-1001234567890": { tools: { deny: ["exec", "read", "write"] }, toolsBySender: { "123456789": { alsoAllow: ["exec"] }, }, }, }, }, }, } ``` Hinweise: * Gruppen-/Kanal-Werkzeugbeschränkungen werden zusätzlich zur globalen/Agenten-Werkzeugrichtlinie angewendet (Verbot gewinnt weiterhin). * Einige Kanäle verwenden unterschiedliche Verschachtelungen für Räume/Kanäle (z. B. Discord `guilds.*.channels.*`, Slack `channels.*`, MS Teams `teams.*.channels.*`). ## Gruppen-Allowlists Wenn `channels.whatsapp.groups`, `channels.telegram.groups` oder `channels.imessage.groups` konfiguriert ist, fungieren die Schlüssel als Gruppen-Allowlist. Verwenden Sie `"*"`, um alle Gruppen zuzulassen und dennoch das Standard-Mention-Verhalten festzulegen. Häufige Intents (Copy/Paste): 1. Alle Gruppenantworten deaktivieren ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { groupPolicy: "disabled" } }, } ``` 2. Nur bestimmte Gruppen zulassen (WhatsApp) ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { groups: { "123@g.us": { requireMention: true }, "456@g.us": { requireMention: false }, }, }, }, } ``` 3. Alle Gruppen zulassen, aber Erwähnung verlangen (explizit) ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { groups: { "*": { requireMention: true } }, }, }, } ``` 4. Nur der Eigentümer kann in Gruppen auslösen (WhatsApp) ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { groupPolicy: "allowlist", groupAllowFrom: ["+15551234567"], groups: { "*": { requireMention: true } }, }, }, } ``` ## Aktivierung (nur Eigentümer) Gruppeneigentümer können die Aktivierung pro Gruppe umschalten: * `/activation mention` * `/activation always` Der Eigentümer wird durch `channels.whatsapp.allowFrom` bestimmt (oder die eigene E.164 des Bots, wenn nicht gesetzt). Senden Sie den Befehl als eigenständige Nachricht. Andere Oberflächen ignorieren derzeit `/activation`. ## Kontextfelder Eingehende Gruppen-Payloads setzen: * `ChatType=group` * `GroupSubject` (falls bekannt) * `GroupMembers` (falls bekannt) * `WasMentioned` (Ergebnis des Mention-Gatings) * Telegram-Forenthemen enthalten außerdem `MessageThreadId` und `IsForum`. Der System-Prompt des Agenten enthält beim ersten Zug einer neuen Gruppensitzung eine Gruppeneinführung. Sie erinnert das Modell daran, wie ein Mensch zu antworten, Markdown-Tabellen zu vermeiden und keine literalen `\n`-Sequenzen zu tippen. ## iMessage-Besonderheiten * Bevorzugen Sie `chat_id:` beim Routing oder Allowlisting. * Chats auflisten: `imsg chats --limit 20`. * Gruppenantworten gehen immer an dieselbe `chat_id` zurück. ## WhatsApp-Besonderheiten Siehe [Gruppennachrichten](/channels/group-messages) für WhatsApp-spezifisches Verhalten (History-Injection, Details zur Erwähnungshandhabung).