Gruppen

OpenClaw wendet dieselben Gruppenregeln auf alle gruppenfähigen Kanäle an, darunter Discord, iMessage, Matrix, Microsoft Teams, QQBot, Signal, Slack, Telegram, WhatsApp und Zalo.

Für dauerhaft aktive Räume, die stillen Kontext bereitstellen sollen, sofern der Agent nicht ausdrücklich eine sichtbare Nachricht sendet, siehe Umgebungsereignisse in Räumen.

Einführung für Einsteiger (2 Minuten)

OpenClaw „lebt“ in Ihren eigenen Messaging-Konten. Es gibt keinen separaten WhatsApp-Bot-Benutzer: Wenn Sie Mitglied einer Gruppe sind, kann OpenClaw diese Gruppe sehen und dort antworten.

Standardverhalten:

• Gruppen sind eingeschränkt (groupPolicy: "allowlist"); Absender in Gruppen werden blockiert, bis sie in die Positivliste aufgenommen wurden.
• Antworten erfordern eine Erwähnung, sofern Sie die Erwähnungssperre für eine Gruppe nicht deaktivieren.
• Der endgültige Antworttext wird automatisch im Raum veröffentlicht (visibleReplies: "automatic").

Das bedeutet: Absender auf der Positivliste können OpenClaw auslösen, indem sie es erwähnen.

Kurzer Ablauf (was mit einer Gruppennachricht geschieht):

groupPolicy? disabled -> verwerfengroupPolicy? allowlist -> Gruppe zugelassen? nein -> verwerfenrequireMention? ja -> erwähnt? nein -> nur als Kontext speichernErwähnung/Antwort/Befehl/DM -> BenutzeranfrageUnterhaltung in dauerhaft aktiver Gruppe -> Benutzeranfrage oder, wenn konfiguriert, Raumereignis

Sichtbare Antworten

Für normale Gruppen-/Kanalanfragen verwendet OpenClaw standardmäßig messages.groupChat.visibleReplies: "automatic": Der endgültige Text des Assistenten wird als sichtbare Antwort im Raum veröffentlicht.

Verwenden Sie messages.groupChat.visibleReplies: "message_tool", wenn der Agent in einem gemeinsam genutzten Raum selbst entscheiden soll, wann er durch den Aufruf von message(action=send) spricht. Dies funktioniert am besten mit Modellen, die Tools zuverlässig verwenden (beispielsweise GPT-5.6 Sol). Wenn das Modell das Tool nicht verwendet und stattdessen substanziellen endgültigen Text zurückgibt, hält OpenClaw diesen Text privat, anstatt ihn im Raum zu veröffentlichen.

Verwenden Sie "automatic" für Modelle oder Runtimes, die eine ausschließlich toolbasierte Zustellung nicht zuverlässig befolgen: Normale endgültige Textantworten werden direkt im Raum veröffentlicht, und der Agent kann weiterhin message(action=send) für Dateien, Bilder oder andere Anhänge aufrufen, die nicht zusammen mit dem endgültigen Text übermittelt werden können.

Wenn das Nachrichten-Tool gemäß der aktiven Tool-Richtlinie nicht verfügbar ist, greift OpenClaw auf automatische sichtbare Antworten zurück, anstatt die Antwort stillschweigend zu unterdrücken. openclaw doctor warnt vor dieser Abweichung.

Für direkte Chats und alle anderen Quellereignisse wendet messages.visibleReplies: "message_tool" dasselbe ausschließlich toolbasierte Verhalten global an; messages.groupChat.visibleReplies bleibt die spezifischere Überschreibung für Gruppen-/Kanalräume. Interne direkte WebChat-Interaktionen verwenden standardmäßig die automatische Zustellung endgültiger Antworten, damit Pi und Codex denselben Vertrag für sichtbare Antworten erhalten.

Der ausschließlich toolbasierte Modus ersetzt das alte Muster, bei dem das Modell für die meisten Interaktionen im Beobachtungsmodus zu einer Antwort mit NO_REPLY gezwungen wurde. Im ausschließlich toolbasierten Modus definiert der Prompt keinen NO_REPLY-Vertrag; nichts sichtbar auszugeben bedeutet einfach, das Nachrichten-Tool nicht aufzurufen.

Plugin-eigene Konversationsbindungen bilden die Ausnahme. Sobald ein Plugin einen Thread bindet und die eingehende Interaktion übernimmt, ist die vom Plugin zurückgegebene Antwort die sichtbare Antwort der Bindung; sie benötigt kein message(action=send). Diese Antwort ist eine Ausgabe der Plugin-Runtime und kein privater endgültiger Modelltext.

Bei direkten Gruppenanfragen werden weiterhin Tippindikatoren gesendet. Umgebungsereignisse dauerhaft aktiver Räume bleiben, sofern aktiviert, strikt und still, solange der Agent nicht das Nachrichten-Tool aufruft.

Sitzungen unterdrücken standardmäßig ausführliche Tool-/Fortschrittszusammenfassungen. Verwenden Sie beim Debuggen /verbose on (oder /verbose full), um sie für die aktuelle Sitzung anzuzeigen, und /verbose off, um zum Verhalten mit ausschließlich endgültigen Antworten zurückzukehren. Der Ausführlichkeitsstatus gilt pro Sitzung und funktioniert in direkten Chats, Gruppen, Kanälen und Forenthemen gleich.

Um nicht erwähnte Unterhaltungen in dauerhaft aktiven Gruppen als stillen Raumkontext statt als Benutzeranfragen zu übermitteln, verwenden Sie Umgebungsereignisse in Räumen:

{  messages: {    groupChat: {      unmentionedInbound: "room_event",    },  },}

Der Standardwert ist unmentionedInbound: "user_request". Erwähnte Nachrichten, Befehle, Abbruchanfragen und DMs bleiben Benutzeranfragen.

So erzwingen Sie, dass sichtbare Ausgaben für Gruppen-/Kanalanfragen über das Nachrichten-Tool erfolgen:

{  messages: {    groupChat: {      visibleReplies: "message_tool",    },  },}

So erzwingen Sie dies für jeden Quellchat:

{  messages: {    visibleReplies: "message_tool",  },}

Das Gateway übernimmt Änderungen an der messages-Konfiguration nach dem Speichern der Datei ohne Neustart. Ein Neustart ist nur erforderlich, wenn das erneute Laden der Konfiguration deaktiviert ist (gateway.reload.mode: "off").

Befehlsinteraktionen umgehen visibleReplies: "message_tool" und antworten immer sichtbar: Sowohl native Slash-Befehle (Discord, Telegram und andere Oberflächen mit nativer Befehlsunterstützung) als auch autorisierte Textbefehle mit /... veröffentlichen ihre Antwort im Quellchat. Nicht autorisierte Textinteraktionen mit /... in Gruppen bleiben ausschließlich über das Nachrichten-Tool sichtbar; gewöhnliche Chatinteraktionen folgen der konfigurierten Standardeinstellung.

Kontextsichtbarkeit und Positivlisten

Für die Gruppensicherheit sind zwei verschiedene Steuerungen relevant:

• Auslöseberechtigung: Wer den Agenten auslösen kann (groupPolicy, groups, groupAllowFrom, kanalspezifische Positivlisten).
• Kontextsichtbarkeit: Welcher ergänzende Kontext in das Modell eingefügt wird (Antwort-/Zitattext, Threadverlauf, weitergeleitete Metadaten).

Standardmäßig behält OpenClaw den Kontext so bei, wie er empfangen wurde: Positivlisten entscheiden darüber, wer Aktionen auslösen kann, nicht darüber, welche zitierten oder historischen Ausschnitte das Modell sieht. Um auch ergänzenden Kontext zu filtern, legen Sie contextVisibility fest:

Legen Sie dies pro Kanal (channels.<channel>.contextVisibility), pro Konto (channels.<channel>.accounts.<accountId>.contextVisibility) oder global (channels.defaults.contextVisibility) fest. Kanäle, die ergänzenden Kontext abrufen (Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp), wenden die Richtlinie beim Erstellen des eingehenden Kontexts an; unbekannte Richtlinienkombinationen schlagen sicher fehl und lassen den Kontext aus.

Wenn Sie Folgendes möchten ...

Informationen zu wiederverwendbaren Absender-Positivlisten finden Sie unter Zugriffsgruppen.

Sitzungsschlüssel

• Gruppensitzungen verwenden Sitzungsschlüssel im Format agent:<agentId>:<channel>:group:<id> (Räume/Kanäle verwenden agent:<agentId>:<channel>:channel:<id>).
• Telegram-Forenthemen ergänzen die Gruppen-ID um :topic:<threadId>, sodass jedes Thema eine eigene Sitzung besitzt.
• Direkte Chats verwenden die Hauptsitzung (oder Sitzungen pro Absender, wenn session.dmScope konfiguriert ist).
• Heartbeats werden in der konfigurierten Heartbeat-Sitzung ausgeführt (Standard: die Hauptsitzung des Agenten); Gruppensitzungen führen keine eigenen Heartbeats aus.

Muster: persönliche DMs und öffentliche Gruppen (einzelner Agent)

Ja – dies funktioniert gut, wenn Ihr „persönlicher“ Datenverkehr aus DMs und Ihr „öffentlicher“ Datenverkehr aus Gruppen besteht.

Der Grund: Im Einzelagentenmodus landen DMs normalerweise unter dem Hauptsitzungsschlüssel (agent:main:main), während Gruppen immer Nicht-Hauptsitzungsschlüssel (agent:main:<channel>:group:<id>) verwenden. Wenn Sie Sandboxing mit mode: "non-main" aktivieren, werden diese Gruppensitzungen im konfigurierten Sandbox-Backend ausgeführt, während Ihre DM-Hauptsitzung auf dem Host verbleibt. Docker ist das Standard-Backend, wenn Sie keines auswählen.

Dadurch erhalten Sie ein Agenten-„Gehirn“ (gemeinsamer Arbeitsbereich und gemeinsamer Speicher), aber zwei Ausführungsmodi:

• DMs: vollständige Tools (Host)
• Gruppen: Sandbox und eingeschränkte Tools

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // Gruppen/Kanäle sind Nicht-Hauptsitzungen -> in der Sandbox        scope: "session", // stärkste Isolierung (ein Container pro Gruppe/Kanal)        workspaceAccess: "none",      },    },  },  tools: {    sandbox: {      tools: {        // Wenn allow nicht leer ist, wird alles andere blockiert (deny hat weiterhin Vorrang).        allow: ["group:messaging", "group:sessions"],        deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"],      },    },  },}

{  agents: {    defaults: {      sandbox: {        mode: "non-main",        scope: "session",        workspaceAccess: "none",        docker: {          binds: [            // hostPath:containerPath:mode            "/home/user/FriendsShared:/data:ro",          ],        },      },    },  },}

Verwandte Themen:

• Konfigurationsschlüssel und Standardwerte: Gateway-Konfiguration
• Debuggen, warum ein Tool blockiert wird: Sandbox im Vergleich zu Tool-Richtlinie und erhöhten Berechtigungen
• Details zu Bind-Mounts: Sandboxing

Anzeigenamen

• UI-Bezeichnungen verwenden displayName, sofern verfügbar, und werden als <channel>:<token> formatiert.
• #room ist für Räume/Kanäle reserviert; Gruppenchats verwenden g-<slug> (Kleinbuchstaben, Leerzeichen -> -, #@+._- beibehalten). Sehr lange undurchsichtige IDs werden zu einem stabilen Token gekürzt, anstatt vollständige Routing-IDs in der UI offenzulegen.

Gruppenrichtlinie

Steuern Sie pro Kanal, wie Gruppen-/Raumnachrichten behandelt werden:

{  channels: {    whatsapp: {      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"      groupAllowFrom: ["+15551234567"],    },    telegram: {      groupPolicy: "disabled",      groupAllowFrom: ["123456789"], // numerische Telegram-Benutzer-ID (Einrichtung löst @username auf)    },    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: { enabled: true } } },      },    },    slack: {      groupPolicy: "allowlist",      channels: { "#general": { enabled: true } },    },    matrix: {      groupPolicy: "allowlist",      groupAllowFrom: ["@owner:example.org"],      groups: {        "!roomId:example.org": { enabled: true },        "#alias:example.org": { enabled: true },      },    },  },}

Schnelles Denkmodell (Auswertungsreihenfolge für Gruppennachrichten):

Erwähnungsprüfung (Standard)

Gruppennachrichten erfordern eine Erwähnung, sofern dies nicht für die jeweilige Gruppe überschrieben wird. Standardwerte befinden sich pro Subsystem unter *.groups."*".

Das Antworten auf eine Bot-Nachricht gilt als implizite Erwähnung, wenn der Kanal Antwortmetadaten bereitstellt; das Zitieren einer Bot-Nachricht kann bei Kanälen, die Zitatmetadaten bereitstellen, ebenfalls als Erwähnung gelten. Derzeit integrierte Fälle: Discord, Microsoft Teams, QQBot, Slack, Telegram, WhatsApp und Zalo Personal.

{  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,        },      },    ],  },}

Geltungsbereich konfigurierter Erwähnungsmuster

Konfigurierte mentionPatterns sind Regex-Fallback-Auslöser. Verwenden Sie sie, wenn die Plattform keine native Bot-Erwähnung bereitstellt oder wenn Klartext wie openclaw: als Erwähnung gelten soll. Native Plattform-Erwähnungen sind davon getrennt: Wenn Discord, Slack, Telegram, Matrix oder ein anderer Kanal nachweisen kann, dass die Nachricht den Bot ausdrücklich erwähnt hat, löst diese native Erwähnung weiterhin aus, auch wenn konfigurierte Regex-Muster ausgeschlossen sind.

Standardmäßig gelten konfigurierte Erwähnungsmuster überall dort, wo der Kanal Provider- und Konversationsdaten an die Erwähnungserkennung übergibt. Um zu verhindern, dass weit gefasste Muster den Agenten in jeder Gruppe aktivieren, begrenzen Sie ihren Geltungsbereich pro Kanal mit channels.<channel>.mentionPatterns.

Verwenden Sie mode: "deny", wenn Regex-Erwähnungsmuster für einen Kanal standardmäßig deaktiviert sein sollen, und aktivieren Sie sie anschließend mit allowIn für bestimmte Räume:

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b", "\\bops bot\\b"],    },  },  channels: {    slack: {      mentionPatterns: {        mode: "deny",        allowIn: ["C0123OPS"],      },    },  },}

Verwenden Sie den Standardwert mode: "allow" (oder lassen Sie mode weg), wenn Regex-Erwähnungsmuster allgemein gelten sollen, und deaktivieren Sie sie anschließend mit denyIn in stark frequentierten Räumen:

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b"],    },  },  channels: {    telegram: {      mentionPatterns: {        denyIn: ["-1001234567890", "-1001234567890:topic:42"],      },    },  },}

Richtlinienauflösung:

Derzeit unterstützte Richtlinien mit begrenztem Regex-Geltungsbereich:

Kanalkonfigurationen auf Kontoebene können dieselbe Richtlinie unter channels.<channel>.accounts.<accountId>.mentionPatterns festlegen, wenn der Kanal mehrere Konten unterstützt. Die Kontorichtlinie hat für dieses Konto Vorrang vor der übergeordneten Kanalrichtlinie.

Tool-Einschränkungen für Gruppen/Kanäle (optional)

Einige Kanalkonfigurationen unterstützen die Einschränkung der Tools, die innerhalb einer bestimmten Gruppe/eines bestimmten Raums/Kanals verfügbar sind.

• tools: Tools für die gesamte Gruppe zulassen/ablehnen (allow, alsoAllow, deny; Ablehnung hat Vorrang).
• toolsBySender: absenderspezifische Überschreibungen innerhalb der Gruppe. Verwenden Sie explizite Schlüsselpräfixe: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> und den Platzhalter "*". Kanal-IDs verwenden kanonische OpenClaw-Kanal-IDs; Aliase wie teams werden zu msteams normalisiert. Veraltete Schlüssel ohne Präfix werden weiterhin akzeptiert, nur als id: abgeglichen und protokollieren eine Veraltungswarnung.

Auflösungsreihenfolge (die spezifischste Regel hat Vorrang):

Beispiel (Telegram):

{  channels: {    telegram: {      groups: {        "*": { tools: { deny: ["exec"] } },        "-1001234567890": {          tools: { deny: ["exec", "read", "write"] },          toolsBySender: {            "id:123456789": { alsoAllow: ["exec"] },          },        },      },    },  },}

Gruppen-Zulassungslisten

Wenn channels.whatsapp.groups, channels.telegram.groups oder channels.imessage.groups konfiguriert ist, dienen die Schlüssel als Gruppen-Zulassungsliste. Verwenden Sie "*", um alle Gruppen zuzulassen und dennoch das standardmäßige Erwähnungsverhalten festzulegen.

Häufige Anwendungsfälle (zum Kopieren und Einfügen):

{  channels: { whatsapp: { groupPolicy: "disabled" } },}

{  channels: {    whatsapp: {      groups: {        "123@g.us": { requireMention: true },        "456@g.us": { requireMention: false },      },    },  },}

{  channels: {    whatsapp: {      groups: { "*": { requireMention: true } },    },  },}

{  channels: {    whatsapp: {      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],      groups: { "*": { requireMention: true } },    },  },}

Aktivierung (nur Eigentümer)

Gruppeneigentümer können die Aktivierung pro Gruppe mit einer eigenständigen Nachricht umschalten:

• /activation mention
• /activation always

/activation ist ein zentraler, dem Eigentümer vorbehaltener Befehl und gilt nur in Gruppenchats. Als Eigentümer gilt ein Absender, der mit allowFrom / commands.ownerAllowFrom des Kanals übereinstimmt (wenn keine Zulassungsliste konfiguriert ist, gilt die eigene ID des Kontos als Eigentümer). Der gespeicherte Modus überschreibt requireMention dieser Gruppe auf Kanälen, die ihn berücksichtigen (Google Chat, QQBot, Telegram, WhatsApp), und die Einleitung des Gruppen-System-Prompts gibt überall den aktiven Modus wieder.

Kontextfelder

Eingehende Gruppen-Payloads setzen:

• ChatType=group
• GroupSubject (falls bekannt)
• GroupMembers (falls bekannt)
• WasMentioned (Ergebnis der Erwähnungsprüfung)
• Telegram-Forumthemen enthalten außerdem MessageThreadId und IsForum.

Der Agent-System-Prompt enthält beim ersten Durchlauf einer neuen Gruppensitzung (und nach Änderungen durch /activation) eine Gruppeneinleitung. Sie erinnert das Modell daran, wie ein Mensch zu antworten, leere Zeilen zu minimieren, die übliche Chat-Formatierung einzuhalten und keine literalen \n-Sequenzen einzugeben. In Gruppen außerhalb von Telegram wird außerdem von Markdown-Tabellen abgeraten; die Richtlinien für Rich Text in Telegram stammen aus dem Prompt des Telegram-Kanals. Vom Kanal stammende Gruppennamen und Teilnehmerbezeichnungen werden als eingezäunte, nicht vertrauenswürdige Metadaten dargestellt, nicht als eingebettete Systemanweisungen.

Besonderheiten von iMessage

• Verwenden Sie für Routing oder Zulassungslisten vorzugsweise chat_id:<id>.
• Chats auflisten: imsg chats --limit 20.
• Gruppenantworten werden immer an dieselbe chat_id zurückgesendet.

WhatsApp-System-Prompts

Die verbindlichen Regeln für WhatsApp-System-Prompts, einschließlich der Auflösung von Gruppen- und Direkt-Prompts, des Platzhalterverhaltens und der Semantik von Kontoüberschreibungen, finden Sie unter WhatsApp.

Besonderheiten von WhatsApp

Informationen zum WhatsApp-spezifischen Verhalten (Verlaufseinbindung, Details zur Verarbeitung von Erwähnungen) finden Sie unter Gruppennachrichten.

Verwandte Themen

• Broadcast-Gruppen
• Kanal-Routing
• Gruppennachrichten
• Kopplung