Skip to main content

​
Ochrona przed pętlą botów

OpenClaw może przyjmować wiadomości napisane przez inne boty w kanałach obsługujących allowBots. Gdy ta ścieżka jest włączona, ochrona przed pętlą par zapobiega nieskończonemu odpowiadaniu sobie nawzajem przez dwie tożsamości botów. Zabezpieczenie jest egzekwowane przez główny mechanizm uruchamiania odpowiedzi przychodzących. Każdy obsługiwany kanał mapuje własne zdarzenie przychodzące na ogólne fakty: konto lub zakres, identyfikator rozmowy, identyfikator bota nadawcy i identyfikator bota odbiorcy. Następnie rdzeń śledzi parę uczestników w obu kierunkach, stosuje budżet w oknie kroczącym i wycisza parę podczas okresu schłodzenia po przekroczeniu budżetu.

​
Domyślne ustawienia

Ochrona przed pętlą par jest aktywna, gdy kanał pozwala wiadomościom utworzonym przez boty trafiać do dyspozycji. Wbudowane wartości domyślne to:
  • maxEventsPerWindow: 20 - para botów może wymienić 20 zdarzeń w oknie
  • windowSeconds: 60 - długość okna kroczącego
  • cooldownSeconds: 60 - czas wyciszenia po przekroczeniu budżetu przez parę
Zabezpieczenie nie wpływa na zwykłe wiadomości napisane przez ludzi, wdrożenia z jednym botem, filtrowanie wiadomości własnych ani jednorazowe odpowiedzi botów, które mieszczą się w budżecie.

​
Konfigurowanie współdzielonych ustawień domyślnych

Ustaw channels.defaults.botLoopProtection raz, aby nadać każdemu obsługiwanemu kanałowi taką samą podstawę. Nadpisania kanałów i kont nadal mogą dostrajać poszczególne powierzchnie. 
{
  channels: {
    defaults: {
      botLoopProtection: {
        maxEventsPerWindow: 20,
        windowSeconds: 60,
        cooldownSeconds: 60,
      },
    },
  },
}
Ustaw enabled: false tylko wtedy, gdy polityka kanału celowo zezwala na rozmowy między botami bez automatycznego wyciszania.

​
Nadpisywanie dla kanału lub konta

Obsługiwane kanały nakładają własną konfigurację na współdzielone ustawienie domyślne. Priorytet jest następujący:
  • channels.<channel>.<room-or-space>.botLoopProtection, gdy kanał obsługuje nadpisania dla poszczególnych rozmów
  • channels.<channel>.accounts.<account>.botLoopProtection, gdy kanał obsługuje konta
  • channels.<channel>.botLoopProtection, gdy kanał obsługuje ustawienia domyślne najwyższego poziomu
  • channels.defaults.botLoopProtection
  • wbudowane ustawienia domyślne
{
  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,
          },
        },
      },
    },
  },
}

​
Obsługa kanałów

  • Discord: natywne fakty author.bot, kluczowane według konta Discord, kanału i pary botów.
  • Slack: natywne fakty bot_id dla zaakceptowanych wiadomości utworzonych przez boty, kluczowane według konta Slack, kanału i pary botów.
  • Matrix: skonfigurowane konta botów Matrix, kluczowane według konta Matrix, pokoju i skonfigurowanej pary botów.
  • Google Chat: natywne fakty sender.type=BOT dla zaakceptowanych wiadomości utworzonych przez boty, kluczowane według konta, przestrzeni i pary botów.
Kanały, które nie ujawniają wiarygodnej tożsamości bota przychodzącego, nadal używają swoich normalnych filtrów wiadomości własnych i polityki dostępu. Nie powinny włączać tego zabezpieczenia, dopóki nie będą mogły zidentyfikować obu uczestników pary botów. Szczegóły implementacji pluginu znajdziesz w środowisku uruchomieniowym SDK.