Protection contre les boucles de bots

OpenClaw peut accepter des messages écrits par d’autres bots sur les canaux qui prennent en charge allowBots. Lorsque ce chemin est activé, la protection contre les boucles entre paires empêche deux identités de bot de se répondre indéfiniment.

La protection est appliquée par le gestionnaire principal des réponses entrantes. Chaque canal compatible convertit son événement entrant en informations génériques : compte ou portée, identifiant de conversation, identifiant du bot émetteur et identifiant du bot destinataire. Le cœur suit la paire de participants dans les deux sens (A vers B et B vers A constituent la même paire), applique un quota sur une fenêtre glissante et bloque la paire pendant une période de temporisation lorsque le quota est dépassé.

Valeurs par défaut

La protection contre les boucles entre paires est active dès qu’un canal autorise les messages créés par des bots à atteindre le répartiteur. Valeurs par défaut intégrées :

La protection n’affecte pas les messages créés par des humains, les déploiements à bot unique, le filtrage des messages du bot lui-même ni les réponses de bots qui restent sous le quota.

Configurer les valeurs par défaut partagées

Définissez channels.defaults.botLoopProtection une seule fois afin d’attribuer la même configuration de référence à tous les canaux compatibles. Les remplacements au niveau du canal, du compte et du salon permettent toujours d’ajuster chaque surface individuellement.

{  channels: {    defaults: {      botLoopProtection: {        maxEventsPerWindow: 20,        windowSeconds: 60,        cooldownSeconds: 60,      },    },  },}

Définissez enabled: false uniquement lorsque la politique de votre canal autorise intentionnellement les conversations entre bots sans blocage automatique.

Remplacer la configuration par canal, compte ou salon

Les canaux compatibles superposent leur propre configuration à la valeur par défaut partagée, clé par clé. Ordre de priorité, de la portée la plus précise à la plus générale :

1. channels.<channel>.<room-or-space>.botLoopProtection, lorsque le canal prend en charge les remplacements par conversation
2. channels.<channel>.accounts.<account>.botLoopProtection, lorsque le canal prend en charge les comptes
3. channels.<channel>.botLoopProtection, lorsque le canal prend en charge les valeurs par défaut de premier niveau
4. channels.defaults.botLoopProtection
5. valeurs par défaut intégrées

{  channels: {    defaults: {      botLoopProtection: {        maxEventsPerWindow: 20,      },    },    discord: {      botLoopProtection: {        maxEventsPerWindow: 8,      },      accounts: {        secondary: {          allowBots: "mentions",          botLoopProtection: {            maxEventsPerWindow: 5,            cooldownSeconds: 90,          },        },      },    },    googlechat: {      allowBots: true,      groups: {        "spaces/AAAA": {          botLoopProtection: {            maxEventsPerWindow: 5,          },        },      },    },    matrix: {      allowBots: "mentions",      groups: {        "!roomid:example.org": {          botLoopProtection: {            maxEventsPerWindow: 5,          },        },      },    },    slack: {      allowBots: "mentions",      botLoopProtection: {        maxEventsPerWindow: 8,      },    },  },}

Prise en charge par les canaux

• Discord : informations natives author.bot, indexées par compte Discord, canal et paire de bots.
• Google Chat : informations natives sender.type=BOT pour les messages de bots acceptés, indexées par compte, espace et paire de bots.
• Matrix : comptes de bots Matrix configurés, indexés par compte Matrix, salon et paire de bots configurée.
• Slack : informations natives bot_id pour les messages de bots acceptés, indexées par compte Slack, canal et paire de bots.

Les canaux qui ne fournissent pas d’identité fiable pour le bot émetteur continuent d’utiliser leurs filtres habituels de messages du bot lui-même et de politique d’accès. Ils ne doivent pas activer cette protection avant de pouvoir identifier les deux participants de la paire de bots.

Consultez l’environnement d’exécution du SDK pour obtenir les détails d’implémentation des plugins.