> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Proteção contra loops de bots

# Proteção contra loops de bots

O OpenClaw pode aceitar mensagens escritas por outros bots em canais que dão suporte a `allowBots`.
Quando esse caminho está habilitado, a proteção contra loops por par impede que duas identidades de bot
respondam uma à outra indefinidamente.

A proteção é aplicada pelo executor central de respostas de entrada. Cada canal compatível
mapeia seu próprio evento de entrada para fatos genéricos: conta ou escopo, id da conversa,
id do bot remetente e id do bot destinatário. Então o núcleo rastreia o par de participantes nas duas
direções, aplica um orçamento de janela deslizante e suprime o par durante um
cooldown depois que o orçamento é excedido.

## Padrões

A proteção contra loops por par fica ativa quando um canal permite que mensagens escritas por bots cheguem ao
despacho. Os padrões integrados são:

* `maxEventsPerWindow: 20` - um par de bots pode trocar 20 eventos dentro da janela
* `windowSeconds: 60` - duração da janela deslizante
* `cooldownSeconds: 60` - tempo de supressão depois que o par excede o orçamento

A proteção não afeta mensagens normais escritas por humanos, implantações com um único bot,
filtragem de mensagens próprias nem respostas únicas de bot que permaneçam abaixo do orçamento.

## Configurar padrões compartilhados

Defina `channels.defaults.botLoopProtection` uma vez para dar a todos os canais compatíveis
a mesma linha de base. Substituições por canal e por conta ainda podem ajustar superfícies
individuais.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    defaults: {
      botLoopProtection: {
        maxEventsPerWindow: 20,
        windowSeconds: 60,
        cooldownSeconds: 60,
      },
    },
  },
}
```

Defina `enabled: false` apenas quando a política do seu canal permitir intencionalmente
conversas bot a bot sem supressão automática.

## Substituir por canal ou conta

Canais compatíveis sobrepõem sua própria configuração ao padrão compartilhado. A precedência é:

* `channels.<channel>.<room-or-space>.botLoopProtection`, quando o canal oferece suporte a substituições por conversa
* `channels.<channel>.accounts.<account>.botLoopProtection`, quando o canal oferece suporte a contas
* `channels.<channel>.botLoopProtection`, quando o canal oferece suporte a padrões de nível superior
* `channels.defaults.botLoopProtection`
* padrões integrados

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  channels: {
    defaults: {
      botLoopProtection: {
        maxEventsPerWindow: 20,
      },
    },
    discord: {
      botLoopProtection: {
        maxEventsPerWindow: 8,
      },
      accounts: {
        molty: {
          allowBots: "mentions",
          botLoopProtection: {
            maxEventsPerWindow: 5,
            cooldownSeconds: 90,
          },
        },
      },
    },
    slack: {
      allowBots: "mentions",
      botLoopProtection: {
        maxEventsPerWindow: 8,
      },
    },
    matrix: {
      allowBots: "mentions",
      groups: {
        "!roomid:example.org": {
          botLoopProtection: {
            maxEventsPerWindow: 5,
          },
        },
      },
    },
    googlechat: {
      allowBots: true,
      groups: {
        "spaces/AAAA": {
          botLoopProtection: {
            maxEventsPerWindow: 5,
          },
        },
      },
    },
  },
}
```

## Suporte por canal

* Discord: fatos nativos de `author.bot`, indexados por conta do Discord, canal e par de bots.
* Slack: fatos nativos de `bot_id` para mensagens aceitas escritas por bots, indexados por conta do Slack, canal e par de bots.
* Matrix: contas de bot do Matrix configuradas, indexadas por conta do Matrix, sala e par de bots configurado.
* Google Chat: fatos nativos de `sender.type=BOT` para mensagens aceitas escritas por bots, indexados por conta, espaço e par de bots.

Canais que não expõem uma identidade de bot de entrada confiável continuam usando seus
filtros normais de mensagens próprias e política de acesso. Eles não devem aderir a essa
proteção até conseguirem identificar os dois participantes no par de bots.

Consulte [runtime do SDK](/pt-BR/plugins/sdk-runtime#reusable-runtime-utilities) para detalhes de implementação do Plugin.