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 :

Clé	Valeur par défaut	Signification
`enabled`	`true`	Protection active pour les canaux qui la prennent en charge.
`maxEventsPerWindow`	`20`	Événements qu’une paire de bots peut échanger pendant la fenêtre.
`windowSeconds`	`60`	Durée de la fenêtre glissante.
`cooldownSeconds`	`60`	Durée du blocage après que la paire a dépassé le quota.

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 :

channels.<channel>.<room-or-space>.botLoopProtection, lorsque le canal prend en charge les remplacements par conversation
channels.<channel>.accounts.<account>.botLoopProtection, lorsque le canal prend en charge les comptes
channels.<channel>.botLoopProtection, lorsque le canal prend en charge les valeurs par défaut de premier niveau
channels.defaults.botLoopProtection
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.

Overview

First steps

Guides

Protection contre les boucles de bots

Valeurs par défaut

Configurer les valeurs par défaut partagées

Remplacer la configuration par canal, compte ou salon

Prise en charge par les canaux

​Valeurs par défaut

​Configurer les valeurs par défaut partagées

​Remplacer la configuration par canal, compte ou salon

​Prise en charge par les canaux

Valeurs par défaut

Configurer les valeurs par défaut partagées

Remplacer la configuration par canal, compte ou salon

Prise en charge par les canaux