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:

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:

1. channels.<channel>.<room-or-space>.botLoopProtection, quando o canal oferece substituições por conversa
2. channels.<channel>.accounts.<account>.botLoopProtection, quando o canal oferece suporte a contas
3. channels.<channel>.botLoopProtection, quando o canal oferece padrões de nível superior
4. channels.defaults.botLoopProtection
5. 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.