Groepen

​

Introductie voor beginners (2 minuten)

• 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").

groupPolicy? disabled -> negeren
groupPolicy? allowlist -> groep toegestaan? nee -> negeren
requireMention? ja -> vermeld? nee -> alleen als context opslaan
vermelding/antwoord/opdracht/privébericht -> gebruikersverzoek
gesprekken in een altijd actieve groep -> gebruikersverzoek, of ruimtegebeurtenis indien geconfigureerd

​

Zichtbare antwoorden

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

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

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

​

Contextzichtbaarheid en toelatingslijsten

• 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).

​

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)

• 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",
          ],
        },
      },
    },
  },
}

• 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

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

​

Vermeldingsvereisten (standaard)

{
  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

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

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

​

Beperkingen voor groeps-/kanaaltools (optioneel)

• 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.

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

​

Toelatingslijsten voor groepen

{
  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)

• /activation mention
• /activation always

​

Contextvelden

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

​

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

​

Bijzonderheden van WhatsApp

​

Gerelateerd

• Uitzendgroepen
• Kanaalroutering
• Groepsberichten
• Koppeling