Proteção contra loop de bots

O OpenClaw pode aceitar mensagens escritas por outros bots em canais compatíveis com allowBots. Quando esse caminho está habilitado, a proteção contra loops entre pares impede que duas identidades de bot respondam uma à outra indefinidamente. A proteção é aplicada pelo executor principal de respostas recebidas. Cada canal compatível mapeia seu evento recebido para informações genéricas: conta ou escopo, ID da conversa, ID do bot remetente e ID do bot destinatário. O núcleo rastreia o par de participantes nas duas direções (A para B e B para A contam como o mesmo par), aplica um limite em uma janela deslizante e suprime o par durante um período de espera após o limite ser excedido.

Padrões

A proteção contra loops entre pares fica ativa sempre que um canal permite que mensagens escritas por bots cheguem ao encaminhamento. Padrões integrados:

Chave	Padrão	Significado
`enabled`	`true`	Proteção ativa para os canais compatíveis.
`maxEventsPerWindow`	`20`	Eventos que um par de bots pode trocar dentro da janela.
`windowSeconds`	`60`	Duração da janela deslizante.
`cooldownSeconds`	`60`	Tempo de supressão após o par exceder o limite.

A proteção não afeta mensagens escritas por humanos, implantações com um único bot, filtragem de mensagens do próprio bot nem respostas de bots que permanecem abaixo do limite.

Configurar padrões compartilhados

Defina channels.defaults.botLoopProtection uma vez para fornecer a todos os canais compatíveis a mesma configuração de base. Substituições por canal, conta e sala ainda podem ajustar superfícies individuais.

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

Defina enabled: false somente quando a política do seu canal permitir intencionalmente conversas entre bots sem supressão automática.

Substituir por canal, conta ou sala

Os canais compatíveis sobrepõem suas próprias configurações ao padrão compartilhado, chave por chave. Precedência, da mais específica para a menos específica:

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

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

Compatibilidade dos canais

Discord: informações nativas de author.bot, identificadas por conta do Discord, canal e par de bots.
Google Chat: informações nativas de sender.type=BOT para mensagens aceitas escritas por bots, identificadas por conta, espaço e par de bots.
Matrix: contas de bot do Matrix configuradas, identificadas por conta do Matrix, sala e par de bots configurado.
Slack: informações nativas de bot_id para mensagens aceitas escritas por bots, identificadas por conta do Slack, canal e par de bots.

Os canais que não expõem uma identidade confiável do bot remetente continuam usando seus filtros normais de mensagens do próprio bot e de política de acesso. Eles não devem adotar essa proteção até conseguirem identificar ambos os participantes do par de bots. Consulte tempo de execução do SDK para obter detalhes sobre a implementação de plugins.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Proteção contra loop de bots

Padrões

Configurar padrões compartilhados

Substituir por canal, conta ou sala

Compatibilidade dos canais

​Padrões

​Configurar padrões compartilhados

​Substituir por canal, conta ou sala

​Compatibilidade dos canais

Padrões

Configurar padrões compartilhados

Substituir por canal, conta ou sala

Compatibilidade dos canais