Wiadomości grupowe WhatsApp w OpenClaw — aktywacja i kontekst

Wprowadzenie

Ta sekcja opisuje zachowanie czatów grupowych WhatsApp w OpenClaw, w tym selektywną aktywację przez wzmianki, zarządzanie sesjami i dostarczanie kontekstu. Wiadomości grupowe WhatsApp mają specyficzne cechy odróżniające je od innych platform.

Tryby aktywacji

System obsługuje dwa tryby operacyjne:

• mention (domyślny) — wymaga wzmianki (ping). Wzmianki działają przez natywne @-mentions WhatsApp, wzorce regex lub numer bota w formacie E.164 w dowolnym miejscu tekstu
• always — odpowiada na każdą wiadomość, zwracając NO_REPLY gdy nie jest w stanie dodać wartości do konwersacji

Zarządzanie sesjami

Klucze sesji grupowych mają format agent:<agentId>:whatsapp:group:<jid>. Dzięki temu dyrektywy grupowe (jak /verbose on) są niezależne od ustawień DM. Heartbeaty celowo pomijają wątki grupowe, aby uniknąć szumu.

Dostarczanie kontekstu

Oczekujące wiadomości (do 50 domyślnie) są wstrzykiwane pod nagłówkiem:

[Chat messages since your last reply - for context]

Bieżący wyzwalacz pojawia się pod:

[Current message - respond to this]

Każda partia kończy się identyfikacją nadawcy: [from: Imię Nadawcy (+48123456789)].

Polityka grupowa

Ustawienie groupPolicy kontroluje akceptację: open, disabled lub allowlist. Listy dozwolonych konfigurowane są przez channels.whatsapp.groupAllowFrom. Prompt systemowy przy pierwszym obrocie zawiera metadane grupy i status aktywacji.

Konfiguracja wzorców wzmianek

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true }
      }
    }
  },
  agents: {
    list: [{
      id: "main",
      groupChat: {
        historyLimit: 50,
        mentionPatterns: ["@?openclaw", "\\+?48123456789"]
      }
    }]
  }
}

Wzorce regex są case-insensitive z zabezpieczeniami — niebezpieczne zagnieżdżone powtórzenia są filtrowane.

Instrukcja użycia

1. Dodaj konto WhatsApp bota do docelowej grupy
2. Wspomnij agenta (@openclaw) lub podaj jego numer
3. Agent odpowie, odwołując się do ostatniego kontekstu i identyfikując nadawcę
4. Komendy sesyjne pozostają w zakresie grupy — sesje DM są oddzielne

Weryfikacja

Przetestuj aktywację, wysyłając wzmiankę i sprawdzając odpowiedź specyficzną dla nadawcy. Przejrzyj logi Gateway z flagą --verbose w poszukiwaniu wpisów inbound web message pokazujących JID grupy i suffix nadawcy.

Szczegóły techniczne

• Tłumienie echa operuje na połączonych ciągach partii
• Wpisy sesji pojawiają się w sessions.json w formacie JID grupy
• Wskaźniki pisania podążają za konfiguracją agents.defaults.typingMode