Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Voortgangsconcepten laten langlopende agentbeurten levendig aanvoelen in chat zonder het gesprek te veranderen in een stapel tijdelijke statusantwoorden. Wanneer voortgangsconcepten zijn ingeschakeld, maakt OpenClaw één zichtbaar werk-in-uitvoeringbericht aan, werkt het bij terwijl de agent leest, plant, tools aanroept of op goedkeuring wacht, en zet dat concept vervolgens om in het definitieve antwoord wanneer het kanaal dat veilig kan doen.
Shelling
- reading recent channel context
- checking matching issues
- preparing reply
Gebruik voortgangsconcepten wanneer je één nette statusmelding wilt tijdens tool-intensief werk en het definitieve antwoord wanneer de beurt klaar is.

Snel Aan De Slag

Schakel voortgangsconcepten per kanaal in met streaming.mode: "progress":
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}
Dat is meestal genoeg. OpenClaw kiest automatisch een label van één woord, voegt compacte voortgangsregels toe terwijl nuttig werk gebeurt, en onderdrukt dubbele losse voortgangspraat voor die beurt.

Wat Gebruikers Zien

Een voortgangsconcept heeft twee delen:
DeelDoel
LabelEen korte titel zoals Thinking of Shelling.
VoortgangsregelsCompacte run-updates zoals toolaanroepen, taakstappen of goedkeuringen.
Het label verschijnt direct wanneer de agent begint te antwoorden. Voortgangsregels worden alleen toegevoegd wanneer de agent nuttige werkupdates uitstuurt. Het definitieve antwoord vervangt het concept wanneer dat mogelijk is; anders stuurt OpenClaw het definitieve antwoord normaal en ruimt het concept op of stopt het met bijwerken ervan volgens het transport van het kanaal.

Kies Een Modus

channels.<channel>.streaming.mode bepaalt het zichtbare gedrag tijdens werk in uitvoering:
ModusBeste voorWat verschijnt in chat
offStille kanalenAlleen het definitieve antwoord.
partialAntwoordtekst zien verschijnenEén concept dat wordt bewerkt met de nieuwste antwoordtekst.
blockGrotere antwoordvoorbeeldblokkenEén voorbeeld dat wordt bijgewerkt of aangevuld in grotere blokken.
progressTool-intensieve of langlopende beurtenEén statusconcept, daarna het definitieve antwoord.
Kies progress wanneer gebruikers meer geven om “wat er gebeurt” dan om het antwoord token voor token te zien streamen. Kies partial wanneer het antwoord zelf het voortgangssignaal is. Kies block wanneer je conceptvoorbeeldupdates in grotere tekstblokken wilt. Op Discord en Telegram is streaming.mode: "block" nog steeds voorbeeldstreaming, niet normale bloklevering. Gebruik streaming.block.enabled of legacy blockStreaming wanneer je normale blokantwoorden wilt.

Labels Configureren

Voortgangslabels staan onder channels.<channel>.streaming.progress. Het standaardlabel is auto, dat kiest uit OpenClaw’s ingebouwde pool met labels van één woord:
Thinking
Shelling
Scuttling
Clawing
Pinching
Molting
Bubbling
Tiding
Reefing
Cracking
Sifting
Brining
Nautiling
Krilling
Barnacling
Lobstering
Tidepooling
Pearling
Snapping
Surfacing
Gebruik een vast label:
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "Investigating",
        },
      },
    },
  },
}
Gebruik je eigen automatische labelpool:
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          labels: ["Checking", "Reading", "Testing", "Finishing"],
        },
      },
    },
  },
}
Verberg het label en toon alleen voortgangsregels:
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: false,
        },
      },
    },
  },
}

Voortgangsregels Beheren

Voortgangsregels zijn standaard ingeschakeld in voortgangsmodus. Ze komen uit echte run-events: toolstarts, itemupdates, taakplannen, goedkeuringen, commando-uitvoer, patchsamenvattingen en vergelijkbare agentactiviteit. Beperk hoeveel regels zichtbaar blijven:
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}
Behoud het enkele voortgangsconcept maar verberg tool- en taakregels:
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          toolProgress: false,
        },
      },
    },
  },
}
Met toolProgress: false onderdrukt OpenClaw nog steeds de oudere losse toolvoortgangsberichten voor die beurt. Het kanaal blijft visueel rustig tot het definitieve antwoord, behalve het label als er een is geconfigureerd.

Kanaalgedrag

Elk kanaal gebruikt het schoonste transport dat het ondersteunt:
KanaalVoortgangstransportOpmerkingen
DiscordStuur één bericht en bewerk het daarna.Definitieve tekst wordt ter plekke bewerkt wanneer die in één veilig voorbeeldbericht past.
MatrixStuur één event en bewerk het daarna.Streamingconfiguratie op accountniveau beheert concepten op accountniveau.
Microsoft TeamsNative Teams-stream in persoonlijke chats.streaming.mode: "block" wordt toegewezen aan Teams-bloklevering.
SlackNative stream of bewerkbaar conceptbericht.Beschikbaarheid van threads beïnvloedt of native streaming kan worden gebruikt.
TelegramStuur één bericht en bewerk het daarna.Oudere zichtbare concepten kunnen worden vervangen zodat definitieve tijdstempels nuttig blijven.
MattermostBewerkbaar conceptbericht.Toolactiviteit wordt samengevoegd in hetzelfde conceptachtige bericht.
Kanalen zonder veilige ondersteuning voor bewerken vallen meestal terug op typindicatoren of levering van alleen het definitieve antwoord.

Afronding

Wanneer het definitieve antwoord klaar is, probeert OpenClaw de chat schoon te houden:
  • Als het concept veilig het definitieve antwoord kan worden, bewerkt OpenClaw het ter plekke.
  • Als het kanaal native voortgangsstreaming gebruikt, rondt OpenClaw die stream af wanneer het native transport de definitieve tekst accepteert.
  • Als het definitieve antwoord media, een goedkeuringsprompt, een expliciet antwoorddoel, te veel chunks, of een mislukte bewerking/verzending heeft, stuurt OpenClaw het definitieve antwoord via het normale leveringspad van het kanaal.
Het fallbackpad is opzettelijk. Het is beter om een nieuw definitief antwoord te sturen dan tekst kwijt te raken, een antwoord in de verkeerde thread te plaatsen, of een concept te overschrijven met een payload die het kanaal niet veilig kan weergeven.

Probleemoplossing

Ik zie alleen het definitieve antwoord. Controleer of channels.<channel>.streaming.mode is ingesteld op progress voor het account of kanaal dat het bericht heeft verwerkt. Sommige groeps- of quote-reply-paden kunnen conceptvoorbeelden voor een beurt uitschakelen wanneer het kanaal het juiste bericht niet veilig kan bewerken. Ik zie het label maar geen toolregels. Controleer streaming.progress.toolProgress. Als dit false is, behoudt OpenClaw het gedrag met één concept maar verbergt het tool- en taakvoortgangsregels. Ik zie een nieuw definitief bericht in plaats van een bewerkt concept. Dat is een veiligheidsfallback. Dit kan gebeuren bij media-antwoorden, lange antwoorden, expliciete antwoorddoelen, oude Telegram-concepten, ontbrekende Slack-threaddoelen, verwijderde voorbeeldberichten of mislukte native streamafronding. Ik zie nog steeds losse voortgangsberichten. Voortgangsmodus onderdrukt standaard losse toolvoortgangsberichten wanneer een concept actief is. Als losse berichten nog steeds verschijnen, controleer dan of de beurt daadwerkelijk voortgangsmodus gebruikt en niet streaming.mode: "off" of een kanaalpad dat geen concept voor dat bericht kan maken. Teams gedraagt zich anders dan Discord of Telegram. Microsoft Teams gebruikt een native stream in persoonlijke chats in plaats van het generieke transport voor verzenden-en-bewerken van voorbeelden. Teams behandelt streaming.mode: "block" ook als Teams-bloklevering omdat het niet dezelfde conceptvoorbeeldblokmodus heeft die Discord en Telegram gebruiken.

Gerelateerd