Skip to main content

​
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. 
{
  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
{
  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 para detalhes de implementação do Plugin.