Szkice postępów

Robocze komunikaty postępu sprawiają, że długotrwałe tury agenta wyglądają w czacie na aktywne, bez zamieniania rozmowy w stos tymczasowych odpowiedzi statusowych. Gdy robocze komunikaty postępu są włączone, OpenClaw tworzy jeden widoczny komunikat pracy w toku dopiero po tym, jak tura pokaże, że wykonuje rzeczywistą pracę, aktualizuje go, gdy agent czyta, planuje, wywołuje narzędzia lub czeka na zatwierdzenie, a następnie zamienia tę wersję roboczą w końcową odpowiedź, gdy kanał może zrobić to bezpiecznie.

Shelling...
📖 from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Bash: run tests

Używaj roboczych komunikatów postępu, gdy chcesz mieć jeden uporządkowany komunikat statusowy podczas pracy intensywnie korzystającej z narzędzi oraz końcową odpowiedź po zakończeniu tury.

Szybki start

Włącz robocze komunikaty postępu dla kanału za pomocą streaming.mode: "progress":

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}

To zwykle wystarcza. OpenClaw wybierze automatyczną jednoznakową etykietę słowną, poczeka, aż praca potrwa co najmniej pięć sekund lub wyemituje drugie zdarzenie pracy, doda zwięzłe wiersze postępu, gdy wykonywana jest użyteczna praca, i wyciszy zduplikowane samodzielne komunikaty postępu dla tej tury.

Co widzą użytkownicy

Roboczy komunikat postępu ma dwie części:

Część	Cel
Etykieta	Krótki wiersz początkowy/statusowy, taki jak `Thinking...` lub `Shelling...`.
Wiersze postępu	Zwięzłe aktualizacje uruchomienia używające tych samych ikon narzędzi i formatera szczegółów co pełne wyjście.

Etykieta pojawia się po tym, jak agent rozpocznie znaczącą pracę i pozostanie zajęty przez pięć sekund albo wyemituje drugie zdarzenie pracy. Jest częścią przewijanej listy wierszy postępu, więc status początkowy przewija się poza widok, gdy pojawi się wystarczająco dużo konkretnej pracy. Odpowiedzi zawierające wyłącznie zwykły tekst nie pokazują roboczego komunikatu postępu. Wiersze postępu są dodawane tylko wtedy, gdy agent emituje użyteczne aktualizacje pracy, na przykład 🛠️ Bash: run tests, 🔎 Web Search: for "discord edit message" lub ✍️ Write: to /tmp/file. Domyślnie używają tego samego zwięzłego trybu objaśniania co /verbose; ustaw agents.defaults.toolProgressDetail: "raw" podczas debugowania, gdy chcesz także dołączać surowe polecenia/szczegóły. Końcowa odpowiedź zastępuje wersję roboczą, gdy to możliwe; w przeciwnym razie OpenClaw wysyła końcową odpowiedź normalnie i porządkuje albo przestaje aktualizować wersję roboczą zgodnie z transportem kanału.

Wybór trybu

channels.<channel>.streaming.mode steruje widocznym zachowaniem pracy w toku:

Tryb	Najlepszy do	Co pojawia się w czacie
`off`	Ciche kanały	Tylko końcowa odpowiedź.
`partial`	Obserwowanie pojawiania się tekstu odpowiedzi	Jedna wersja robocza edytowana najnowszym tekstem odpowiedzi.
`block`	Większe fragmenty podglądu odpowiedzi	Jeden podgląd aktualizowany lub dołączany w większych fragmentach.
`progress`	Tury intensywnie korzystające z narzędzi lub długotrwałe	Jedna wersja robocza statusu, potem końcowa odpowiedź.

Wybierz progress, gdy użytkownikom bardziej zależy na tym, „co się dzieje”, niż na obserwowaniu strumieniowania tekstu odpowiedzi token po tokenie. Wybierz partial, gdy sama odpowiedź jest sygnałem postępu. Wybierz block, gdy chcesz aktualizacji podglądu wersji roboczej w większych fragmentach tekstu. W Discord i Telegram streaming.mode: "block" nadal oznacza strumieniowanie podglądu, a nie zwykłe dostarczanie blokowe. Użyj streaming.block.enabled albo starszego blockStreaming, gdy chcesz zwykłych odpowiedzi blokowych.

Konfigurowanie etykiet

Etykiety postępu znajdują się w channels.<channel>.streaming.progress. Domyślna etykieta to auto, która wybiera z wbudowanej w OpenClaw puli jednoznakowych etykiet słownych z wielokropkiem:

Thinking...
Shelling...
Scuttling...
Clawing...
Pinching...
Molting...
Bubbling...
Tiding...
Reefing...
Cracking...
Sifting...
Brining...
Nautiling...
Krilling...
Barnacling...
Lobstering...
Tidepooling...
Pearling...
Snapping...
Surfacing...

Użyj stałej etykiety:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "Investigating",
        },
      },
    },
  },
}

Użyj własnej automatycznej puli etykiet:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          labels: ["Checking", "Reading", "Testing", "Finishing"],
        },
      },
    },
  },
}

Ukryj etykietę i pokaż tylko wiersze postępu:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: false,
        },
      },
    },
  },
}

Sterowanie wierszami postępu

Wiersze postępu są domyślnie włączone w trybie postępu. Pochodzą z rzeczywistych zdarzeń uruchomienia: startów narzędzi, aktualizacji elementów, planów zadań, zatwierdzeń, wyjścia poleceń, podsumowań poprawek i podobnej aktywności agenta. OpenClaw używa tego samego formatera dla roboczych komunikatów postępu i /verbose:

{
  agents: {
    defaults: {
      toolProgressDetail: "explain", // explain | raw
    },
  },
}

"explain" jest wartością domyślną i utrzymuje stabilność wersji roboczych dzięki zwięzłym etykietom, takim jak 🛠️ check JS syntax for /tmp/app.js. "raw" dołącza bazowe polecenie/szczegół, gdy jest dostępne, co jest przydatne podczas debugowania, ale bardziej hałaśliwe w czacie. Na przykład to samo polecenie wygląda inaczej w zależności od trybu szczegółowości:

Tryb	Wiersz postępu
`explain`	`🛠️ check JS syntax for /tmp/app.js`
`raw`	`🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js`

Ogranicz liczbę widocznych wierszy:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}

Wiersze postępu są automatycznie kompaktowane, aby ograniczyć przełamywanie układu dymka czatu podczas edycji wersji roboczej. OpenClaw domyślnie skraca długie wiersze postępu, aby powtarzane edycje wersji roboczej nie zawijały się inaczej przy każdej aktualizacji. Prefiks pozostaje czytelny, a długie szczegóły, takie jak ścieżki lub surowe polecenia, są skracane wielokropkiem. Slack może renderować wiersze postępu jako ustrukturyzowane pola Block Kit zamiast pojedynczej treści tekstowej:

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          render: "rich",
        },
      },
    },
  },
}

Renderowanie wzbogacone zachowuje ten sam awaryjny tekst zwykły, aby kanały i klienci, które nie obsługują bogatszej formy, nadal mogły wyświetlać zwięzły tekst postępu. Zachowaj pojedynczy roboczy komunikat postępu, ale ukryj wiersze narzędzi i zadań:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          toolProgress: false,
        },
      },
    },
  },
}

Przy toolProgress: false OpenClaw nadal wycisza starsze samodzielne komunikaty postępu narzędzi dla tej tury. Kanał pozostaje wizualnie cichy aż do końcowej odpowiedzi, z wyjątkiem etykiety, jeśli została skonfigurowana.

Zachowanie kanałów

Każdy kanał używa najczystszego obsługiwanego transportu:

Kanał	Transport postępu	Uwagi
Discord	Wyślij jedną wiadomość, potem ją edytuj.	Końcowy tekst jest edytowany w miejscu, gdy mieści się w jednym bezpiecznym komunikacie podglądu.
Matrix	Wyślij jedno zdarzenie, potem je edytuj.	Konfiguracja strumieniowania na poziomie konta steruje wersjami roboczymi na poziomie konta.
Microsoft Teams	Natywny strumień Teams w czatach osobistych.	`streaming.mode: "block"` mapuje się na dostarczanie blokowe Teams.
Slack	Natywny strumień albo edytowalny post roboczy.	Dostępność wątku wpływa na to, czy można użyć natywnego strumieniowania.
Telegram	Wyślij jedną wiadomość, potem ją edytuj.	Starsze widoczne wersje robocze mogą zostać zastąpione, aby końcowe znaczniki czasu pozostały użyteczne.
Mattermost	Edytowalny post roboczy.	Aktywność narzędzi jest składana do tego samego posta w stylu wersji roboczej.

Kanały bez bezpiecznej obsługi edycji zwykle wracają do wskaźników pisania albo dostarczania wyłącznie końcowej odpowiedzi.

Finalizacja

Gdy końcowa odpowiedź jest gotowa, OpenClaw próbuje utrzymać porządek w czacie:

Jeśli wersja robocza może bezpiecznie stać się końcową odpowiedzią, OpenClaw edytuje ją w miejscu.
Jeśli kanał używa natywnego strumieniowania postępu, OpenClaw finalizuje ten strumień, gdy natywny transport akceptuje końcowy tekst.
Jeśli końcowa odpowiedź zawiera media, monit o zatwierdzenie, jawny cel odpowiedzi, zbyt wiele fragmentów albo nieudaną edycję/wysyłkę, OpenClaw wysyła końcową odpowiedź zwykłą ścieżką dostarczania kanału.

Ścieżka awaryjna jest celowa. Lepiej wysłać świeżą końcową odpowiedź niż utracić tekst, błędnie przypisać odpowiedź do wątku albo nadpisać wersję roboczą ładunkiem, którego kanał nie może bezpiecznie reprezentować.

Rozwiązywanie problemów

Widzę tylko końcową odpowiedź. Sprawdź, czy channels.<channel>.streaming.mode jest ustawione na progress dla konta lub kanału, który obsłużył wiadomość. Niektóre ścieżki grupowe lub odpowiedzi z cytatem mogą wyłączyć podglądy wersji roboczej dla tury, gdy kanał nie może bezpiecznie edytować właściwej wiadomości. Widzę etykietę, ale nie widzę wierszy narzędzi. Sprawdź streaming.progress.toolProgress. Jeśli ma wartość false, OpenClaw zachowuje zachowanie pojedynczej wersji roboczej, ale ukrywa wiersze postępu narzędzi i zadań. Widzę świeżą końcową wiadomość zamiast edytowanej wersji roboczej. To awaryjny mechanizm bezpieczeństwa. Może wystąpić przy odpowiedziach z mediami, długich odpowiedziach, jawnych celach odpowiedzi, starych wersjach roboczych Telegram, brakujących celach wątków Slack, usuniętych wiadomościach podglądu albo nieudanej finalizacji natywnego strumienia. Nadal widzę samodzielne komunikaty postępu. Tryb postępu wycisza domyślne samodzielne komunikaty postępu narzędzi, gdy wersja robocza jest aktywna. Jeśli samodzielne komunikaty nadal się pojawiają, sprawdź, czy tura rzeczywiście używa trybu postępu, a nie streaming.mode: "off" albo ścieżki kanału, która nie może utworzyć wersji roboczej dla tej wiadomości. Teams zachowuje się inaczej niż Discord lub Telegram. Microsoft Teams używa natywnego strumienia w czatach osobistych zamiast ogólnego transportu podglądu polegającego na wysłaniu i edycji. Teams traktuje też streaming.mode: "block" jako dostarczanie blokowe Teams, ponieważ nie ma tego samego trybu blokowego podglądu wersji roboczej, którego używają Discord i Telegram.

Documentation Index

​Szybki start

​Co widzą użytkownicy

​Wybór trybu

​Konfigurowanie etykiet

​Sterowanie wierszami postępu

​Zachowanie kanałów

​Finalizacja

​Rozwiązywanie problemów

​Powiązane