Wiadomości¶

Ta strona spina sposób, w jaki OpenClaw obsługuje wiadomości przychodzące, sesje, kolejkowanie, strumieniowanie oraz widoczność rozumowania.

Przepływ wiadomości (wysoki poziom)¶

Inbound message
  -> routing/bindings -> session key
  -> queue (if a run is active)
  -> agent run (streaming + tools)
  -> outbound replies (channel limits + chunking)

Kluczowe ustawienia znajdują się w konfiguracji:

• messages.* dla prefiksów, kolejkowania i zachowania w grupach.
• agents.defaults.* dla strumieniowania blokowego i domyślnych ustawień porcjowania.
• Nadpisania per kanał (channels.whatsapp.*, channels.telegram.* itd.) dla limitów i przełączników strumieniowania.

Pełny schemat: Konfiguracja.

Deduplikacja przychodzących¶

Kanały mogą ponownie dostarczyć tę samą wiadomość po ponownym połączeniu. OpenClaw utrzymuje krótkotrwałą pamięć podręczną kluczowaną przez kanał/konto/peer/sesję/ID wiadomości, aby zduplikowane dostarczenia nie uruchamiały kolejnego przebiegu agenta.

Debouncing przychodzących¶

Szybkie, następujące po sobie wiadomości od tego samego nadawcy mogą być łączone w jedną turę agenta poprzez messages.inbound. Debouncing jest zakresowany per kanał + konwersacja i używa najnowszej wiadomości do wątkowania odpowiedzi/ID.

Konfiguracja (globalna domyślna + nadpisania per kanał):

{
  messages: {
    inbound: {
      debounceMs: 2000,
      byChannel: {
        whatsapp: 5000,
        slack: 1500,
        discord: 1500,
      },
    },
  },
}

Uwagi:

• Debounce dotyczy wiadomości tylko tekstowych; media/załączniki są opróżniane natychmiast.
• Polecenia kontrolne omijają debouncing, aby pozostały samodzielne.

Sesje i urządzenia¶

Sesje są własnością Gateway, a nie klientów.

• Czaty bezpośrednie zapadają się do głównego klucza sesji agenta.
• Grupy/kanały otrzymują własne klucze sesji.
• Magazyn sesji i transkrypty znajdują się na hoście Gateway.

Wiele urządzeń/kanałów może mapować do tej samej sesji, ale historia nie jest w pełni synchronizowana z powrotem do każdego klienta. Rekomendacja: używaj jednego głównego urządzenia do długich rozmów, aby uniknąć rozbieżnego kontekstu. Control UI i TUI zawsze pokazują transkrypt sesji oparty o Gateway, więc stanowią źródło prawdy.

Szczegóły: Zarządzanie sesjami.

Treści przychodzące i kontekst historii¶

OpenClaw rozdziela treść promptu od treści polecenia:

• Body: tekst promptu wysyłany do agenta. Może zawierać koperty kanału i opcjonalne opakowania historii.
• CommandBody: surowy tekst użytkownika do parsowania dyrektyw/poleceń.
• RawBody: starszy alias dla CommandBody (zachowany dla kompatybilności).

Gdy kanał dostarcza historię, używa wspólnego opakowania:

• [Chat messages since your last reply - for context]
• [Current message - respond to this]

Dla czatów niedyrektywnych (grupy/kanały/pokoje) bieżąca treść wiadomości jest poprzedzona etykietą nadawcy (ten sam styl, co dla wpisów historii). Zapewnia to spójność wiadomości w czasie rzeczywistym oraz kolejkowanych/historii w promptcie agenta.

Bufory historii są tylko oczekujące: obejmują wiadomości grupowe, które nie uruchomiły przebiegu (na przykład wiadomości bramkowane wzmianką) i wykluczają wiadomości już znajdujące się w transkrypcie sesji.

Usuwanie dyrektyw dotyczy wyłącznie sekcji bieżącej wiadomości, dzięki czemu historia pozostaje nienaruszona. Kanały, które opakowują historię, powinny ustawić CommandBody (lub RawBody) na oryginalny tekst wiadomości i zachować Body jako połączony prompt. Bufory historii są konfigurowalne poprzez messages.groupChat.historyLimit (domyślne globalnie) oraz nadpisania per kanał, takie jak channels.slack.historyLimit lub channels.telegram.accounts.<id>.historyLimit (ustaw 0, aby wyłączyć).

Kolejkowanie i follow-upy¶

Jeśli przebieg jest już aktywny, wiadomości przychodzące mogą być kolejkowane, kierowane do bieżącego przebiegu lub zbierane na turę follow-up.

• Konfiguracja poprzez messages.queue (oraz messages.queue.byChannel).
• Tryby: interrupt, steer, followup, collect, plus warianty backlogu.

Szczegóły: Kolejkowanie.

Strumieniowanie, porcjowanie i batchowanie¶

Strumieniowanie blokowe wysyła częściowe odpowiedzi w miarę, jak model produkuje bloki tekstu. Porcjowanie respektuje limity tekstu kanału i unika dzielenia ogrodzonych bloków kodu.

Kluczowe ustawienia:

• agents.defaults.blockStreamingDefault (on|off, domyślnie wyłączone)
• agents.defaults.blockStreamingBreak (text_end|message_end)
• agents.defaults.blockStreamingChunk (minChars|maxChars|breakPreference)
• agents.defaults.blockStreamingCoalesce (batchowanie oparte na bezczynności)
• agents.defaults.humanDelay (ludzka pauza między odpowiedziami blokowymi)
• Nadpisania per kanał: *.blockStreaming oraz *.blockStreamingCoalesce (kanały inne niż Telegram wymagają jawnego *.blockStreaming: true)

Szczegóły: Strumieniowanie + porcjowanie.

Widoczność rozumowania i tokeny¶

OpenClaw może ujawniać lub ukrywać rozumowanie modelu:

• /reasoning on|off|stream kontroluje widoczność.
• Treści rozumowania nadal wliczają się do użycia tokenów, gdy są generowane przez model.
• Telegram obsługuje strumień rozumowania do bańki szkicowej.

Szczegóły: Dyrektywy myślenia + rozumowania oraz Użycie tokenów.

Prefiksy, wątkowanie i odpowiedzi¶

Formatowanie wiadomości wychodzących jest scentralizowane w messages:

• messages.responsePrefix, channels.<channel>.responsePrefix i channels.<channel>.accounts.<id>.responsePrefix (kaskada prefiksów wychodzących) oraz channels.whatsapp.messagePrefix (prefiks przychodzący WhatsApp)
• Wątkowanie odpowiedzi poprzez replyToMode oraz domyślne ustawienia per kanał

Szczegóły: Konfiguracja oraz dokumentacja kanałów.