Groepen

OpenClaw past dezelfde groepsregels toe op alle kanalen die groepen ondersteunen, waaronder Discord, iMessage, Matrix, Microsoft Teams, QQBot, Signal, Slack, Telegram, WhatsApp en Zalo.

Zie Omgevingsgebeurtenissen voor ruimtes voor altijd actieve ruimtes die stille context moeten bieden, tenzij de agent expliciet een zichtbaar bericht verzendt.

Introductie voor beginners (2 minuten)

OpenClaw ‘leeft’ in je eigen berichtenaccounts. Er is geen afzonderlijke WhatsApp-botgebruiker: als je in een groep zit, kan OpenClaw die groep zien en daar reageren.

Standaardgedrag:

• Groepen zijn beperkt (groupPolicy: "allowlist"); afzenders in groepen worden geblokkeerd totdat ze aan de toelatingslijst zijn toegevoegd.
• Voor antwoorden is een vermelding vereist, tenzij je de vermeldingsfilter voor een groep uitschakelt.
• De definitieve antwoordtekst wordt automatisch in de ruimte geplaatst (visibleReplies: "automatic").

Kortom: afzenders op de toelatingslijst kunnen OpenClaw activeren door het te vermelden.

Beknopt verloop (wat er met een groepsbericht gebeurt):

groupPolicy? disabled -> negerengroupPolicy? allowlist -> groep toegestaan? nee -> negerenrequireMention? ja -> vermeld? nee -> alleen als context opslaanvermelding/antwoord/opdracht/privébericht -> gebruikersverzoekgesprekken in een altijd actieve groep -> gebruikersverzoek, of ruimtegebeurtenis indien geconfigureerd

Zichtbare antwoorden

Voor normale groeps-/kanaalverzoeken gebruikt OpenClaw standaard messages.groupChat.visibleReplies: "automatic": de definitieve assistenttekst wordt als zichtbaar antwoord in de ruimte geplaatst.

Gebruik messages.groupChat.visibleReplies: "message_tool" wanneer de agent in een gedeelde ruimte zelf moet kunnen bepalen wanneer die spreekt door message(action=send) aan te roepen. Dit werkt het best met modellen die betrouwbaar hulpmiddelen gebruiken (bijvoorbeeld GPT-5.6 Sol). Als het model het hulpmiddel niet gebruikt en inhoudelijke definitieve tekst retourneert, houdt OpenClaw die tekst privé in plaats van deze in de ruimte te plaatsen.

Gebruik "automatic" voor modellen of runtimes die bezorging uitsluitend via hulpmiddelen niet betrouwbaar volgen: normale definitieve tekst wordt rechtstreeks in de ruimte geplaatst en de agent kan nog steeds message(action=send) aanroepen voor bestanden, afbeeldingen of andere bijlagen die niet met de definitieve tekst kunnen worden meegestuurd.

Als het berichtenhulpmiddel volgens het actieve hulpmiddelenbeleid niet beschikbaar is, valt OpenClaw terug op automatische zichtbare antwoorden in plaats van het antwoord stilzwijgend te onderdrukken. openclaw doctor waarschuwt voor deze discrepantie.

Voor directe chats en alle andere brongebeurtenissen past messages.visibleReplies: "message_tool" hetzelfde gedrag uitsluitend via hulpmiddelen wereldwijd toe; messages.groupChat.visibleReplies blijft de specifiekere overschrijving voor groeps-/kanaalruimtes. Directe beurten in de interne WebChat gebruiken standaard automatische bezorging van het definitieve antwoord, zodat Pi en Codex hetzelfde contract voor zichtbare antwoorden krijgen.

De modus uitsluitend via hulpmiddelen vervangt het oude patroon waarbij het model voor de meeste beurten in de meeleesmodus werd gedwongen NO_REPLY te antwoorden. In de modus uitsluitend via hulpmiddelen definieert de prompt geen NO_REPLY-contract; niets zichtbaars doen betekent simpelweg dat het berichtenhulpmiddel niet wordt aangeroepen.

Door Plugins beheerde gespreksbindingen vormen de uitzondering. Zodra een Plugin een thread bindt en de inkomende beurt claimt, is het door de Plugin geretourneerde antwoord het zichtbare bindingsantwoord; hiervoor is message(action=send) niet nodig. Dat antwoord is uitvoer van de Plugin-runtime, geen definitieve privétekst van het model.

Typindicatoren worden nog steeds verzonden voor directe groepsverzoeken. Omgevingsgebeurtenissen voor altijd actieve ruimtes blijven, indien ingeschakeld, strikt en stil tenzij de agent het berichtenhulpmiddel aanroept.

Sessies onderdrukken standaard uitgebreide samenvattingen van hulpmiddelen/voortgang. Gebruik /verbose on (of /verbose full) om ze tijdens het opsporen van fouten voor de huidige sessie weer te geven, en /verbose off om terug te keren naar gedrag met alleen definitieve antwoorden. De uitgebreide status geldt per sessie en werkt hetzelfde in directe chats, groepen, kanalen en forumonderwerpen.

Gebruik Omgevingsgebeurtenissen voor ruimtes om niet-vermelde gesprekken in altijd actieve groepen als stille ruimtecontext in plaats van als gebruikersverzoeken in te dienen:

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

De standaardwaarde is unmentionedInbound: "user_request". Vermelde berichten, opdrachten, afbreekverzoeken en privéberichten blijven gebruikersverzoeken.

Om te vereisen dat zichtbare uitvoer voor groeps-/kanaalverzoeken via het berichtenhulpmiddel verloopt:

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

Om dit voor elke bronchat te vereisen:

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

De Gateway neemt configuratiewijzigingen aan messages zonder herstart over nadat het bestand is opgeslagen. Herstart alleen wanneer het opnieuw laden van de configuratie is uitgeschakeld (gateway.reload.mode: "off").

Opdrachtbeurten omzeilen visibleReplies: "message_tool" en antwoorden altijd zichtbaar: zowel systeemeigen slashopdrachten (Discord, Telegram en andere oppervlakken met systeemeigen opdrachtondersteuning) als geautoriseerde tekstuele /...-opdrachten plaatsen hun antwoord in de bronchat. Niet-geautoriseerde tekstuele /...-beurten in groepen blijven uitsluitend via het berichtenhulpmiddel verlopen; gewone chatbeurten volgen de geconfigureerde standaard.

Contextzichtbaarheid en toelatingslijsten

Bij groepsbeveiliging zijn twee verschillende instellingen betrokken:

• Activeringsautorisatie: wie de agent kan activeren (groupPolicy, groups, groupAllowFrom, kanaalspecifieke toelatingslijsten).
• Contextzichtbaarheid: welke aanvullende context in het model wordt ingevoegd (antwoord-/citaattekst, threadgeschiedenis, doorgestuurde metagegevens).

OpenClaw behoudt de context standaard zoals die is ontvangen: toelatingslijsten bepalen wie acties kan activeren, niet welke geciteerde of historische fragmenten het model ziet. Stel contextVisibility in om ook aanvullende context te filteren:

Stel dit per kanaal (channels.<channel>.contextVisibility), per account (channels.<channel>.accounts.<accountId>.contextVisibility) of wereldwijd (channels.defaults.contextVisibility) in. Kanalen die aanvullende context ophalen (Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp) passen het beleid toe bij het opbouwen van inkomende context; onbekende beleidscombinaties worden uit veiligheid geweigerd en laten de context weg.

Deze modi filteren alleen door het kanaal aangeleverde aanvullende context. Het hulpmiddelenbeleid en de uitsluitend voor de eigenaar beschikbare hulpmiddeleninventaris worden nog steeds geselecteerd op basis van de oorspronkelijke aanvrager van de huidige beurt, niet op basis van elke afzender die in de prompt wordt weergegeven. Zie Aanvragerspecifieke instellingen en promptcontext.

Als je het volgende wilt...

Zie Toegangsgroepen voor herbruikbare toelatingslijsten voor afzenders.

Sessiesleutels

• Groepssessies gebruiken agent:<agentId>:<channel>:group:<id>-sessiesleutels (ruimtes/kanalen gebruiken agent:<agentId>:<channel>:channel:<id>).
• Telegram-forumonderwerpen voegen :topic:<threadId> toe aan de groeps-id, zodat elk onderwerp een eigen sessie heeft.
• Directe chats gebruiken de hoofdsessie (of sessies per afzender als session.dmScope is geconfigureerd).
• Heartbeats worden uitgevoerd in de geconfigureerde Heartbeat-sessie (standaard: de hoofdsessie van de agent); groepssessies voeren geen eigen Heartbeats uit.

Patroon: persoonlijke privéberichten + openbare groepen (één agent)

Ja — dit werkt goed als je ‘persoonlijke’ verkeer uit privéberichten bestaat en je ‘openbare’ verkeer uit groepen.

Reden: in de modus met één agent komen privéberichten doorgaans terecht onder de hoofdsessiesleutel (agent:main:main), terwijl groepen altijd niet-hoofdsessiesleutels gebruiken (agent:main:<channel>:group:<id>). Als je sandboxing inschakelt met mode: "non-main", worden die groepssessies uitgevoerd in de geconfigureerde sandboxbackend, terwijl je hoofdprivéberichtsessie op de host blijft. Docker is de standaardbackend als je er geen kiest.

Dit geeft je één agent-‘brein’ (gedeelde werkruimte + geheugen), maar twee uitvoeringsprofielen:

• Privéberichten: volledige hulpmiddelen (host)
• Groepen: sandbox + beperkte hulpmiddelen

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // groepen/kanalen zijn niet-hoofd -> in sandbox        scope: "session", // sterkste isolatie (één container per groep/kanaal)        workspaceAccess: "none",      },    },  },  tools: {    sandbox: {      tools: {        // Als allow niet leeg is, wordt al het overige geblokkeerd (deny heeft nog steeds voorrang).        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",          ],        },      },    },  },}

Gerelateerd:

• Configuratiesleutels en standaardwaarden: Gateway-configuratie
• Opsporen waarom een hulpmiddel is geblokkeerd: Sandbox versus hulpmiddelenbeleid versus verhoogde rechten
• Details over bind-mounts: Sandboxing

Weergavelabels

• UI-labels gebruiken displayName wanneer beschikbaar, opgemaakt als <channel>:<token>.
• #room is gereserveerd voor ruimtes/kanalen; groepschats gebruiken g-<slug> (kleine letters, spaties -> -, behoud #@+._-). Zeer lange ondoorzichtige id's worden ingekort tot een stabiel token, zodat volledige route-id's niet in de UI uitlekken.

Groepsbeleid

Bepaal per kanaal hoe groeps-/ruimteberichten worden verwerkt:

{  channels: {    whatsapp: {      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"      groupAllowFrom: ["+15551234567"],    },    telegram: {      groupPolicy: "disabled",      groupAllowFrom: ["123456789"], // numerieke Telegram-gebruikers-ID (de configuratie zet @username om)    },    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 },      },    },  },}

Beknopt mentaal model (evaluatievolgorde voor groepsberichten):

Vermeldingsvereisten (standaard)

Groepsberichten vereisen een vermelding, tenzij dit per groep wordt overschreven. Standaardwaarden staan per subsysteem onder *.groups."*".

Ondersteunde impliciete vermeldingsfeiten zijn kanaalspecifiek:

Elk feit is standaard ingeschakeld wanneer het kanaal het produceert. Stel de bijbehorende implicitMentions-vlag in op false om te voorkomen dat dit feit de vermeldingsvereisten omzeilt; systeemeigen expliciete vermeldingen blijven ongewijzigd. Een vlag heeft geen effect op kanalen die dat feit niet produceren.

{  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: {    entries: {      main: {        groupChat: {          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],          historyLimit: 50,        },      },    },  },}

Bereik van geconfigureerde vermeldingspatronen bepalen

Geconfigureerde mentionPatterns zijn regex-terugvaltriggers. Gebruik ze wanneer het platform geen systeemeigen botvermelding beschikbaar stelt, of wanneer je wilt dat platte tekst zoals openclaw: als een vermelding geldt. Systeemeigen platformvermeldingen staan hiervan los: wanneer Discord, Slack, Telegram, Matrix, Signal of een ander kanaal kan aantonen dat het bericht de bot expliciet vermeldde, activeert die systeemeigen vermelding de bot nog steeds, zelfs als geconfigureerde regex-patronen worden geweigerd.

Geconfigureerde vermeldingspatronen zijn standaard overal van toepassing waar het kanaal provider- en gespreksfeiten doorgeeft aan vermeldingsdetectie. Om te voorkomen dat brede patronen de agent in elke groep activeren, bepaal je hun bereik per kanaal met channels.<channel>.mentionPatterns.

Gebruik mode: "deny" wanneer regex-vermeldingspatronen standaard uitgeschakeld moeten zijn voor een kanaal en schakel ze vervolgens voor specifieke ruimten in met allowIn:

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

Gebruik de standaardwaarde mode: "allow" (of laat mode weg) wanneer regex-vermeldingspatronen breed van toepassing moeten zijn en schakel ze vervolgens in rumoerige ruimten uit met denyIn:

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

Beleidsbepaling:

Momenteel ondersteund beleid voor het bereik van regex-patronen:

Kanaalconfiguraties op accountniveau kunnen hetzelfde beleid instellen onder channels.<channel>.accounts.<accountId>.mentionPatterns wanneer dat kanaal meerdere accounts ondersteunt. Het accountbeleid heeft voor dat account voorrang op het kanaalbeleid op het hoogste niveau.

Beperkingen voor groeps-/kanaaltools (optioneel)

Sommige kanaalconfiguraties ondersteunen het beperken van welke tools beschikbaar zijn binnen een specifieke groep/ruimte/kanaal.

• tools: sta tools toe of weiger ze voor de hele groep (allow, alsoAllow, deny; weigeren heeft voorrang).
• toolsBySender: overschrijvingen per afzender binnen de groep. Gebruik expliciete sleutelvoorvoegsels: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> en het jokerteken "*". Kanaal-ID's gebruiken canonieke OpenClaw-kanaal-ID's; aliassen zoals teams worden genormaliseerd naar msteams. Verouderde sleutels zonder voorvoegsel worden nog steeds geaccepteerd, komen alleen overeen als id: en registreren een verouderingswaarschuwing.

Volgorde van bepaling (meest specifiek heeft voorrang):

Voorbeeld (Telegram):

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

Toelatingslijsten voor groepen

Wanneer channels.whatsapp.groups, channels.telegram.groups of channels.imessage.groups is geconfigureerd, fungeren de sleutels als een toelatingslijst voor groepen. Gebruik "*" om alle groepen toe te staan en toch het standaardvermeldingsgedrag in te stellen.

Veelvoorkomende doelen (kopiëren/plakken):

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

Activering (alleen eigenaar)

Groepseigenaren kunnen de activering per groep omschakelen met een afzonderlijk bericht:

• /activation mention
• /activation always

/activation is een kernopdracht die alleen voor eigenaren beschikbaar is en alleen van toepassing is in groepschats. Eigenaar betekent dat de afzender overeenkomt met commands.ownerAllowFrom; kanaallijsten in allowFrom bepalen alleen de gewone kanaal- en opdrachttoegang. De opgeslagen modus overschrijft de requireMention van die groep voor kanalen die deze raadplegen (Google Chat, QQBot, Telegram, WhatsApp), en de inleiding van de groepssysteemprompt weerspiegelt overal de actieve modus.

Contextvelden

Binnenkomende groepspayloads stellen het volgende in:

• ChatType=group
• GroupSubject (indien bekend)
• GroupMembers (indien bekend)
• WasMentioned (resultaat van vermeldingscontrole)
• Telegram-forumonderwerpen bevatten ook MessageThreadId en IsForum.

De agentsysteemprompt bevat een groepsinleiding bij de eerste beurt van een nieuwe groepssessie (en nadat /activation verandert). Deze herinnert het model eraan om als een mens te reageren, lege regels te beperken en de normale spatiëring van chats te volgen, en geen letterlijke \n-reeksen te typen. Kanalen waarvan de opgegeven tabelmodus geen native of onbewerkte tabellen behoudt, raden Markdown-tabellen eveneens af. Van kanalen afkomstige groepsnamen en deelnemerslabels worden weergegeven als omheinde, niet-vertrouwde metadata, niet als inline systeeminstructies.

Bijzonderheden van iMessage

• Geef de voorkeur aan chat_id:<id> bij routering of opname in een toelatingslijst.
• Chats weergeven: imsg chats --limit 20.
• Groepsantwoorden gaan altijd terug naar dezelfde chat_id.

WhatsApp-systeemprompts

Zie WhatsApp voor de canonieke regels voor WhatsApp-systeemprompts, waaronder de verwerking van groeps- en directe prompts, jokertekengedrag en de semantiek van accountoverschrijvingen.

Bijzonderheden van WhatsApp

Zie Groepsberichten voor gedrag dat alleen voor WhatsApp geldt (geschiedenisinjectie, details over de verwerking van vermeldingen).

Gerelateerd

• Uitzendgroepen
• Kanaalroutering
• Groepsberichten
• Koppeling