Wiadomości

Wiadomość przychodząca
  -> routing/powiązania -> klucz sesji
  -> deduplikacja + debounce
  -> kolejka (jeśli uruchomienie jest już aktywne)
  -> uruchomienie agenta (strumieniowanie + narzędzia)
  -> odpowiedzi wychodzące (limity kanału + dzielenie na fragmenty)

• messages.* dla prefiksów, kolejkowania, debounce wiadomości przychodzących i zachowania grup.
• agents.defaults.* dla strumieniowania blokowego, dzielenia na fragmenty i domyślnych ustawień cichych odpowiedzi.
• Nadpisania kanałów (channels.telegram.*, channels.whatsapp.* itd.) dla limitów poszczególnych kanałów i przełączników strumieniowania.

​

Deduplikacja wiadomości przychodzących

​

Debounce wiadomości przychodzących

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

• Debounce dotyczy wyłącznie wiadomości tekstowych; multimedia i załączniki powodują natychmiastowe opróżnienie bufora.
• Polecenia sterujące (stop/abort/status itd.) omijają debounce, dzięki czemu są przekazywane natychmiast.
• Domyślnie wyłączone: messages.inbound.debounceMs nie ma wbudowanej wartości domyślnej, więc debounce jest aktywowany dopiero po jego ustawieniu (globalnie lub dla kanału).
• Opcjonalne ustawienie coalesceSameSenderDms w iMessage jest jedynym wyjątkiem: wstrzymuje wszystkie wiadomości tekstowe DM od tego samego nadawcy (w tym polecenia) wystarczająco długo, aby rozdzielone przez Apple wysłanie polecenia i adresu URL dotarło jako jedna tura. Czaty grupowe są zawsze przekazywane natychmiast, niezależnie od tego ustawienia.

​

Sesje i urządzenia

• Czaty bezpośrednie są łączone w główny klucz sesji agenta.
• Grupy/kanały otrzymują własne klucze sesji.
• Magazyn sesji i transkrypcje znajdują się na hoście Gateway.

​

Treść promptów i kontekst historii

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

​

Metadane wyników narzędzi

• toolResult.details jest usuwane przed ponownym odtworzeniem u dostawcy i przed przekazaniem danych wejściowych do Compaction.
• Utrwalone transkrypcje sesji zachowują tylko ograniczone details; zbyt duże metadane są zastępowane zwięzłym podsumowaniem oznaczonym persistedDetailsTruncated: true.
• Pluginy i narzędzia powinny umieszczać tekst, który model musi odczytać, w content, a nie wyłącznie w details.

​

Kolejkowanie i wiadomości uzupełniające

​

Własność uruchomienia kanału

​

Strumieniowanie, dzielenie na fragmenty i grupowanie

• agents.defaults.blockStreamingDefault (on|off, domyślnie off)
• agents.defaults.blockStreamingBreak (text_end|message_end)
• agents.defaults.blockStreamingChunk (minChars|maxChars|breakPreference)
• agents.defaults.blockStreamingCoalesce (grupowanie na podstawie bezczynności)
• agents.defaults.humanDelay (przerwa przypominająca ludzką między odpowiedziami blokowymi)
• Nadpisania kanałów: *.streaming.block.enabled i *.streaming.block.coalesce w dołączonych kanałach; nieaktualne płaskie klucze są migrowane przez openclaw doctor --fix. Strumieniowanie blokowe jest wyłączone, chyba że zostanie jawnie włączone — na każdym kanale, w tym Telegram. QQ Bot stanowi wyjątek: nie ma kluczy streaming.block i strumieniuje odpowiedzi blokowe, chyba że channels.qqbot.streaming.mode ma wartość "off".

​

Widoczność rozumowania i tokeny

• /reasoning on|off|stream steruje widocznością.
• Treść rozumowania nadal wlicza się do użycia tokenów, gdy model ją generuje.
• Telegram obsługuje strumieniowanie rozumowania do tymczasowego dymka wersji roboczej, który jest usuwany po ostatecznym dostarczeniu; aby uzyskać trwałe dane wyjściowe rozumowania, należy użyć /reasoning on.

​

Prefiksy, wątki i odpowiedzi

• Kaskada prefiksów wychodzących: messages.responsePrefix, channels.<channel>.responsePrefix, channels.<channel>.accounts.<id>.responsePrefix. WhatsApp ma również channels.whatsapp.messagePrefix dla prefiksu wiadomości przychodzących.
• Tworzenie wątków odpowiedzi za pomocą replyToMode i wartości domyślnych dla poszczególnych kanałów.

​

Ciche odpowiedzi

• Konwersacje bezpośrednie nigdy nie otrzymują wskazówek promptu NO_REPLY. Jeśli bezpośrednie uruchomienie przypadkowo zwróci sam cichy token, OpenClaw go pomija, zamiast przepisywać lub dostarczać.
• Grupy/kanały domyślnie zezwalają na ciszę. W trybie widocznych odpowiedzi message_tool cisza oznacza, że model nie wywołuje message(action=send).
• Wewnętrzna orkiestracja domyślnie zezwala na ciszę.

​

Powiązane

• Refaktoryzacja cyklu życia wiadomości - docelowy trwały projekt wysyłania i odbierania
• Strumieniowanie - dostarczanie wiadomości w czasie rzeczywistym
• Ponawianie - zachowanie ponawiania dostarczania wiadomości
• Kolejka - kolejka przetwarzania wiadomości
• Kanały - integracje z platformami komunikacyjnymi