Bot-Schleifenschutz

OpenClaw kann auf Kanälen, die allowBots unterstützen, von anderen Bots verfasste Nachrichten annehmen. Wenn dieser Pfad aktiviert ist, verhindert der Schleifenschutz für Bot-Paare, dass zwei Bot-Identitäten einander unbegrenzt antworten. Der Schutz wird vom zentralen Runner für eingehende Antworten durchgesetzt. Jeder unterstützende Kanal bildet sein eingehendes Ereignis auf generische Fakten ab: Konto oder Geltungsbereich, Konversations-ID, Bot-ID des Absenders und Bot-ID des Empfängers. Der Kern verfolgt das Teilnehmerpaar in beiden Richtungen (A zu B und B zu A gelten als dasselbe Paar), wendet ein Budget mit gleitendem Zeitfenster an und unterdrückt das Paar für eine Abklingzeit, nachdem das Budget überschritten wurde.

Standardwerte

Der Schleifenschutz für Bot-Paare ist immer aktiv, wenn ein Kanal zulässt, dass von Bots verfasste Nachrichten zur Verarbeitung weitergeleitet werden. Integrierte Standardwerte:

Schlüssel	Standardwert	Bedeutung
`enabled`	`true`	Schutz für Kanäle aktiv, die ihn unterstützen.
`maxEventsPerWindow`	`20`	Ereignisse, die ein Bot-Paar im Zeitfenster austauschen kann.
`windowSeconds`	`60`	Länge des gleitenden Zeitfensters.
`cooldownSeconds`	`60`	Unterdrückungsdauer, nachdem das Paar das Budget überschritten hat.

Der Schutz wirkt sich nicht auf von Menschen verfasste Nachrichten, Bereitstellungen mit nur einem Bot, die Filterung eigener Nachrichten oder Bot-Antworten aus, die unter dem Budget bleiben.

Gemeinsame Standardwerte konfigurieren

Legen Sie channels.defaults.botLoopProtection einmal fest, um allen unterstützenden Kanälen dieselbe Ausgangskonfiguration zuzuweisen. Kanäle können auch spezifischere Überschreibungen bereitstellen; Feishu verwendet absichtlich nur diese gemeinsame Ausgangskonfiguration.

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

Legen Sie enabled: false nur fest, wenn Ihre Kanalrichtlinie Bot-zu-Bot-Konversationen bewusst ohne automatische Unterdrückung zulässt.

Nach Kanal, Konto oder Raum überschreiben

Unterstützende Kanäle legen ihre eigene Konfiguration Schlüssel für Schlüssel über den gemeinsamen Standardwert. Prioritätsreihenfolge, beginnend mit der spezifischsten Ebene:

channels.<channel>.<room-or-space>.botLoopProtection, wenn der Kanal konversationsspezifische Überschreibungen unterstützt
channels.<channel>.accounts.<account>.botLoopProtection, wenn der Kanal Konten unterstützt
channels.<channel>.botLoopProtection, wenn der Kanal Standardwerte auf oberster Ebene unterstützt
channels.defaults.botLoopProtection
integrierte Standardwerte

{
  channels: {
    defaults: {
      botLoopProtection: {
        maxEventsPerWindow: 20,
      },
    },
    discord: {
      botLoopProtection: {
        maxEventsPerWindow: 8,
      },
      accounts: {
        secondary: {
          allowBots: true,
          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,
      },
    },
  },
}

Kanalunterstützung

Discord: native author.bot-Fakten, nach Discord-Konto, Kanal und Bot-Paar verschlüsselt.
Feishu: native sender_type=bot-Fakten für zugelassene, von Bots verfasste Gruppennachrichten, nach Feishu-Konto, Chat und Bot-Paar verschlüsselt. Feishu verwendet nur channels.defaults.botLoopProtection.
Google Chat: native sender.type=BOT-Fakten für akzeptierte, von Bots verfasste Nachrichten, nach Konto, Space und Bot-Paar verschlüsselt.
Matrix: konfigurierte Matrix-Bot-Konten, nach Matrix-Konto, Raum und konfiguriertem Bot-Paar verschlüsselt.
Slack: native bot_id-Fakten für akzeptierte, von Bots verfasste Nachrichten, nach Slack-Konto, Kanal und Bot-Paar verschlüsselt.

Kanäle, die keine zuverlässige Identität des eingehenden Bots bereitstellen, verwenden weiterhin ihre normalen Filter für eigene Nachrichten und Zugriffsrichtlinien. Sie sollten diesen Schutz erst aktivieren, wenn sie beide Teilnehmer des Bot-Paars identifizieren können. Implementierungsdetails für Plugins finden Sie unter SDK-Laufzeit.

Start here

FAQ

Testing

Diagnostics

Community and meta

Bot-Schleifenschutz

Standardwerte

Gemeinsame Standardwerte konfigurieren

Nach Kanal, Konto oder Raum überschreiben

Kanalunterstützung

​Standardwerte

​Gemeinsame Standardwerte konfigurieren

​Nach Kanal, Konto oder Raum überschreiben

​Kanalunterstützung

Standardwerte

Gemeinsame Standardwerte konfigurieren

Nach Kanal, Konto oder Raum überschreiben

Kanalunterstützung