Przejdź do głównej treści

​
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.