Groupes

​

Présentation pour débutants (2 minutes)

• Les groupes sont restreints (groupPolicy: "allowlist") ; les expéditeurs des groupes sont bloqués jusqu’à leur ajout à la liste d’autorisation.
• Les réponses nécessitent une mention, sauf si vous désactivez cette exigence pour un groupe.
• Le texte de la réponse finale est automatiquement publié dans le salon (visibleReplies: "automatic").

groupPolicy ? désactivée -> ignorer
groupPolicy ? liste d’autorisation -> groupe autorisé ? non -> ignorer
requireMention ? oui -> mentionné ? non -> stocker uniquement comme contexte
mention/réponse/commande/message privé -> requête utilisateur
conversation d’un groupe toujours actif -> requête utilisateur, ou événement de salon si configuré

​

Réponses visibles

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

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

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

​

Visibilité du contexte et listes d’autorisation

• Autorisation de déclenchement : qui peut déclencher l’agent (groupPolicy, groups, groupAllowFrom, listes d’autorisation propres aux canaux).
• Visibilité du contexte : quel contexte supplémentaire est injecté dans le modèle (texte de réponse ou de citation, historique du fil de discussion, métadonnées transférées).

​

Clés de session

• Les sessions de groupe utilisent des clés de session agent:<agentId>:<channel>:group:<id> (les salons et canaux utilisent agent:<agentId>:<channel>:channel:<id>).
• Les sujets de forum Telegram ajoutent :topic:<threadId> à l’identifiant du groupe afin que chaque sujet dispose de sa propre session.
• Les conversations directes utilisent la session principale (ou des sessions propres à chaque expéditeur si session.dmScope est configuré).
• Les Heartbeats s’exécutent dans la session de heartbeat configurée (par défaut : la session principale de l’agent) ; les sessions de groupe n’exécutent pas leurs propres heartbeats.

​

Modèle : messages privés personnels et groupes publics (agent unique)

• Messages privés : outils complets (hôte)
• Groupes : environnement isolé et outils restreints

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // les groupes/canaux ne sont pas principaux -> isolés
        scope: "session", // isolation la plus forte (un conteneur par groupe/canal)
        workspaceAccess: "none",
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        // Si allow n’est pas vide, tout le reste est bloqué (deny reste prioritaire).
        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: [
            // cheminHôte:cheminConteneur:mode
            "/home/user/FriendsShared:/data:ro",
          ],
        },
      },
    },
  },
}

• Clés de configuration et valeurs par défaut : Configuration du Gateway
• Déterminer pourquoi un outil est bloqué : Environnement isolé ou politique d’outils ou mode élevé
• Détails des montages liés : Environnement isolé

​

Libellés d’affichage

• Les libellés de l’interface utilisateur utilisent displayName lorsque cette valeur est disponible, avec le format <channel>:<token>.
• #room est réservé aux salons et canaux ; les conversations de groupe utilisent g-<slug> (minuscules, espaces remplacés par -, conserver #@+._-). Les identifiants opaques très longs sont raccourcis en un jeton stable afin d’éviter d’exposer les identifiants de routage complets dans l’interface utilisateur.

​

Politique de groupe

{
  channels: {
    whatsapp: {
      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"
      groupAllowFrom: ["+15551234567"],
    },
    telegram: {
      groupPolicy: "disabled",
      groupAllowFrom: ["123456789"], // identifiant utilisateur Telegram numérique (la configuration résout @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: { 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 },
      },
    },
  },
}

​

Filtrage par mention (par défaut)

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

​

Définir la portée des motifs de mention configurés

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

​

Restrictions des outils par groupe/canal (facultatif)

• tools : autorise/refuse des outils pour l’ensemble du groupe (allow, alsoAllow, deny ; le refus prévaut).
• toolsBySender : remplacements par expéditeur au sein du groupe. Utilisez des préfixes de clé explicites : channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> et le caractère générique "*". Les identifiants de canal utilisent les identifiants de canal OpenClaw canoniques ; les alias tels que teams sont normalisés en msteams. Les anciennes clés sans préfixe sont toujours acceptées, correspondent uniquement comme id: et génèrent un avertissement d’obsolescence dans le journal.

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

​

Listes d’autorisation de groupes

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

​

Activation (propriétaire uniquement)

• /activation mention
• /activation always

​

Champs de contexte

• ChatType=group
• GroupSubject (si connu)
• GroupMembers (si connu)
• WasMentioned (résultat du filtrage par mention)
• Les sujets de forum Telegram incluent également MessageThreadId et IsForum.

​

Particularités d’iMessage

• Privilégiez chat_id:<id> pour le routage ou l’ajout à une liste d’autorisation.
• Répertorier les discussions : imsg chats --limit 20.
• Les réponses de groupe sont toujours renvoyées vers le même chat_id.

​

Invites système de WhatsApp

​

Particularités de WhatsApp

​

Pages associées

• Groupes de diffusion
• Routage des canaux
• Messages de groupe
• Association