Toegangsgroepen

Toegangsgroepen zijn benoemde afzenderlijsten die je één keer definieert onder accessGroups en vanuit kanaaltoelatingslijsten verwijst met accessGroup:<name>. Gebruik ze wanneer dezelfde personen toegang moeten hebben tot meerdere berichtkanalen, of wanneer één vertrouwde groep moet gelden voor zowel DM’s als autorisatie van groepsafzenders. Een groep verleent op zichzelf niets. De groep is alleen relevant waar een toelatingslijstveld ernaar verwijst.

Statische groepen berichtafzenders

Statische afzendergroepen gebruiken type: "message.senders". members is geïndexeerd op berichtkanaal-id, plus "*" voor vermeldingen die door elk kanaal worden gedeeld:

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        "*": ["global-owner-id"],
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
        whatsapp: ["+15551234567"],
      },
    },
  },
}

Sleutel	Betekenis
`"*"`	Gedeelde vermeldingen die worden gecontroleerd voor elk berichtkanaal dat naar de groep verwijst.
`discord`, `telegram`, …	Vermeldingen die alleen worden gecontroleerd voor overeenkomsten met de toelatingslijst van dat kanaal.

Vermeldingen worden vergeleken volgens de normale allowFrom-regels van het bestemmingskanaal. OpenClaw vertaalt afzender-id’s niet tussen kanalen: als Alice een Telegram-id en een Discord-id heeft, vermeld je beide id’s onder de bijbehorende kanaalsleutels.

Naar groepen verwijzen vanuit toelatingslijsten

Verwijs met accessGroup:<name> naar een groep op elke plek waar het berichtkanaalpad toelatingslijsten voor afzenders ondersteunt. Voorbeeld van een DM-toelatingslijst:

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
      },
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators"],
    },
    telegram: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators"],
    },
  },
}

Voorbeeld van een toelatingslijst voor groepsafzenders:

{
  accessGroups: {
    oncall: {
      type: "message.senders",
      members: {
        whatsapp: ["+15551234567"],
        googlechat: ["users/1234567890"],
      },
    },
  },
  channels: {
    whatsapp: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["accessGroup:oncall"],
    },
    googlechat: {
      groups: {
        "spaces/AAA": {
          users: ["accessGroup:oncall"],
        },
      },
    },
  },
}

Je kunt groepen en rechtstreekse vermeldingen combineren:

{
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators", "discord:123456789012345678"],
    },
  },
}

Ondersteunde berichtkanaalpaden

Toegangsgroepen werken in de gedeelde autorisatiepaden voor berichtkanalen:

Toelatingslijsten voor DM-afzenders, zoals channels.<channel>.allowFrom
Toelatingslijsten voor groepsafzenders, zoals channels.<channel>.groupAllowFrom
Kanaalspecifieke toelatingslijsten per ruimte voor afzenders die dezelfde regels voor afzendervergelijking gebruiken (bijvoorbeeld Google Chat groups.<space>.users)
Paden voor opdrachtautorisatie die toelatingslijsten voor afzenders van berichtkanalen hergebruiken

Kanaalondersteuning hangt ervan af of dat kanaal is aangesloten op de gedeelde OpenClaw-helpers voor afzenderautorisatie. De huidige gebundelde ondersteuning omvat ClickClack, Discord, Feishu, Google Chat, iMessage, IRC, LINE, Mattermost, Microsoft Teams, Nextcloud Talk, Nostr, QQ Bot, Signal, Slack, SMS, Telegram, WhatsApp, Zalo en Zalo Personal. Statische message.senders-groepen zijn kanaalonafhankelijk, zodat nieuwe berichtkanalen ze krijgen door de gedeelde ingress-helpers van de plugin-SDK te gebruiken in plaats van aangepaste uitbreiding van toelatingslijsten.

Discord-kanaaldoelgroepen

Discord ondersteunt ook een dynamisch toegangsgroeptype:

{
  accessGroups: {
    maintainers: {
      type: "discord.channelAudience",
      guildId: "1456350064065904867",
      channelId: "1456744319972282449",
      membership: "canViewChannel",
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:maintainers"],
    },
  },
}

discord.channelAudience betekent “Discord-DM-afzenders toestaan die dit guildkanaal momenteel kunnen bekijken.” OpenClaw zoekt de afzender op het moment van autorisatie op via Discord en past de Discord-machtigingsregels voor ViewChannel toe. membership is optioneel en is standaard ingesteld op canViewChannel. Gebruik dit wanneer een Discord-kanaal al de gezaghebbende bron voor een team is, zoals #maintainers of #on-call. Vereisten en gedrag bij fouten:

De bot heeft toegang tot de guild en het kanaal nodig.
De bot heeft in het Discord Developer Portal Server Members Intent nodig.
De toegangsgroep weigert standaard toegang wanneer Discord Missing Access retourneert, de afzender niet als guildlid kan worden gevonden of het kanaal bij een andere guild hoort.

Meer Discord-specifieke voorbeelden: Discord-toegangsbeheer

Plugin-diagnostiek

Plugin-auteurs kunnen de gestructureerde status van toegangsgroepen inspecteren zonder deze opnieuw uit te breiden tot een platte toelatingslijst:

import { resolveAccessGroupAllowFromState } from "openclaw/plugin-sdk/access-groups";

const state = await resolveAccessGroupAllowFromState({
  accessGroups: cfg.accessGroups,
  allowFrom: channelConfig.allowFrom,
  channel: "my-channel",
  accountId: "default",
  senderId,
  isSenderAllowed,
});

Het resultaat rapporteert groepen waarnaar wordt verwezen en groepen die overeenkomen, ontbreken, niet worden ondersteund of zijn mislukt. Gebruik dit voor diagnostiek of conformiteitstests. Gebruik expandAllowFromWithAccessGroups(...) alleen voor compatibiliteitspaden die nog steeds een platte allowFrom-array verwachten.

Beveiligingsopmerkingen

Toegangsgroepen zijn aliassen voor toelatingslijsten, geen rollen. Ze maken geen eigenaren aan, keuren geen koppelingsverzoeken goed en verlenen op zichzelf geen hulpmachtigingen.
dmPolicy: "open" vereist nog steeds "*" in de effectieve DM-toelatingslijst. Verwijzen naar een toegangsgroep is niet hetzelfde als openbare toegang.
Ontbrekende groepsnamen weigeren standaard toegang. Als allowFrom accessGroup:operators bevat en accessGroups.operators ontbreekt, autoriseert die vermelding niemand.
Houd kanaal-id’s stabiel. Geef de voorkeur aan numerieke id’s of gebruikers-id’s boven weergavenamen wanneer het kanaal beide ondersteunt.

Probleemoplossing

Als een afzender zou moeten overeenkomen maar wordt geblokkeerd:

Controleer of het toelatingslijstveld de exacte accessGroup:<name>-verwijzing bevat.
Controleer of accessGroups.<name>.type correct is.
Controleer of het afzender-id onder de bijbehorende kanaalsleutel of onder "*" staat.
Controleer of de vermelding de normale toelatingslijstsyntaxis van dat kanaal gebruikt.
Controleer voor Discord-kanaaldoelgroepen of de bot het guildkanaal kan zien en Server Members Intent is ingeschakeld.

Voer openclaw doctor uit nadat je de configuratie voor toegangsbeheer hebt bewerkt. Hiermee worden veel ongeldige combinaties van toelatingslijsten en beleidsregels vóór runtime gedetecteerd.

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Statische groepen berichtafzenders

Naar groepen verwijzen vanuit toelatingslijsten

Ondersteunde berichtkanaalpaden

Discord-kanaaldoelgroepen

Plugin-diagnostiek

Beveiligingsopmerkingen

Probleemoplossing

​Statische groepen berichtafzenders

​Naar groepen verwijzen vanuit toelatingslijsten

​Ondersteunde berichtkanaalpaden

​Discord-kanaaldoelgroepen

​Plugin-diagnostiek

​Beveiligingsopmerkingen

​Probleemoplossing

Statische groepen berichtafzenders

Naar groepen verwijzen vanuit toelatingslijsten

Ondersteunde berichtkanaalpaden

Discord-kanaaldoelgroepen

Plugin-diagnostiek

Beveiligingsopmerkingen

Probleemoplossing