Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.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 pas één zichtbaar onder-handen-werk-bericht nadat de beurt aantoont dat er echt werk wordt gedaan, werkt het dit bij terwijl de agent leest, plant, tools aanroept of op goedkeuring wacht, en verandert dat concept daarna in het definitieve antwoord wanneer het kanaal dat veilig kan doen. 
Shelling...
📖 from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Bash: run tests
Gebruik voortgangsconcepten wanneer je één nette statusmelding wilt tijdens toolintensief werk en het definitieve antwoord wanneer de beurt klaar is.

​
Snelstart

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, wacht tot het werk minstens vijf seconden duurt of een tweede werkgebeurtenis uitzendt, voegt compacte voortgangsregels toe terwijl nuttig werk plaatsvindt, en onderdrukt dubbele losse voortgangspraat voor die beurt.

​
Wat gebruikers zien

Een voortgangsconcept heeft twee onderdelen:
OnderdeelDoel
LabelEen korte start-/statusregel zoals Thinking... of Shelling....
VoortgangsregelsCompacte uitvoerupdates met dezelfde toolpictogrammen en detailformatter als uitgebreide uitvoer.
Het label verschijnt nadat de agent met betekenisvol werk begint en ofwel vijf seconden bezig blijft of een tweede werkgebeurtenis uitzendt. Het maakt deel uit van de doorlopende lijst met voortgangsregels, zodat de startstatus wegscrollt zodra er genoeg concreet werk verschijnt. Antwoorden met alleen platte tekst tonen geen voortgangsconcept. Voortgangsregels worden alleen toegevoegd wanneer de agent nuttige werkupdates uitzendt, bijvoorbeeld 🛠️ Bash: run tests, 🔎 Web Search: for "discord edit message" of ✍️ Write: to /tmp/file. Standaard gebruiken ze dezelfde compacte uitlegmodus als /verbose; stel agents.defaults.toolProgressDetail: "raw" in tijdens het debuggen als je ook onbewerkte opdrachten/details toegevoegd wilt hebben. Het definitieve antwoord vervangt het concept wanneer dat mogelijk is; anders verstuurt OpenClaw het definitieve antwoord normaal en ruimt het concept op of stopt het met bijwerken volgens het transport van het kanaal.

​
Kies een modus

channels.<channel>.streaming.mode bepaalt het zichtbare onderhanden gedrag:
ModusBest voorWat in chat verschijnt
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.
progressToolintensieve of langlopende beurtenEén statusconcept, daarna het definitieve antwoord.
Kies progress wanneer gebruikers meer geven om “wat er gebeurt” dan om de antwoordtekst 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, geen normale bloklevering. Gebruik streaming.block.enabled of de oudere 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 labelpool met één woord en puntjes: 
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 de progress-modus. Ze komen uit echte uitvoergebeurtenissen: toolstarts, itemupdates, taakplannen, goedkeuringen, opdrachtuitvoer, patchsamenvattingen en vergelijkbare agentactiviteit. OpenClaw gebruikt dezelfde formatter voor voortgangsconcepten en /verbose: 
{
  agents: {
    defaults: {
      toolProgressDetail: "explain", // explain | raw
    },
  },
}
"explain" is de standaard en houdt concepten stabiel met beknopte labels zoals 🛠️ check JS syntax for /tmp/app.js. "raw" voegt de onderliggende opdracht/detail toe wanneer beschikbaar, wat handig is tijdens het debuggen maar rumoeriger is in chat. Dezelfde opdracht verschijnt bijvoorbeeld anders afhankelijk van de detailmodus:
ModusVoortgangsregel
explain🛠️ check JS syntax for /tmp/app.js
raw🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js
Beperk hoeveel regels zichtbaar blijven: 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}
Voortgangsregels worden automatisch samengeperst om herschikking van chatballonnen te verminderen terwijl het concept wordt bewerkt. OpenClaw kapt lange voortgangsregels standaard af, zodat herhaalde conceptbewerkingen niet bij elke update anders afbreken. Het voorvoegsel blijft leesbaar, en lange details zoals paden of onbewerkte opdrachten worden ingekort met puntjes. Slack kan voortgangsregels renderen als gestructureerde Block Kit-velden in plaats van één tekstbody: 
{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          render: "rich",
        },
      },
    },
  },
}
Rijke rendering behoudt dezelfde plattetekstfallback, zodat kanalen en clients die de rijkere vorm niet ondersteunen nog steeds de compacte voortgangstekst kunnen tonen. 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 stil tot het definitieve antwoord, behalve het label als er een is geconfigureerd.

​
Kanaalgedrag

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

​
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 blokken of een mislukte bewerking/verzending heeft, verstuurt OpenClaw het definitieve antwoord via het normale leveringspad van het kanaal.
Het fallbackpad is bewust. Het is beter om een nieuw definitief antwoord te versturen dan tekst te verliezen, een antwoord verkeerd te threaden 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 afgehandeld. Sommige groeps- of quote-antwoordpaden 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-threadtargets, verwijderde voorbeeldberichten of mislukte afronding van native streams. Ik zie nog steeds losse voortgangsberichten. De progress-modus onderdrukt standaard losse toolvoortgangsberichten wanneer een concept actief is. Als losse berichten nog steeds verschijnen, controleer dan of de beurt daadwerkelijk de progress-modus 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 voorbeeldtransport met versturen en bewerken. Teams behandelt streaming.mode: "block" ook als Teams-bloklevering, omdat het niet dezelfde blokmodus met conceptvoorbeelden heeft die Discord en Telegram gebruiken.

​
Gerelateerd