Concept internals

Markdown-opmaak

OpenClaw zet uitgaande Markdown vóór het renderen van kanaalspecifieke uitvoer om in een gedeelde tussenrepresentatie (IR). De IR bevat platte tekst plus stijl-/linkbereiken, zodat één parseerstap elk kanaal bedient en het opdelen de opmaak nooit midden in een bereik splitst.

Pijplijn

Markdown naar IR parseren (markdownToIR) - platte tekst plus stijlbereiken (vet, cursief, doorgestreept, code, codeblok, spoiler, blokcitaat, kopniveau 1-6) en linkbereiken. Posities zijn UTF-16-code-eenheden, zodat de stijlbereiken van Signal rechtstreeks aansluiten op de API. Tabellen worden alleen geparseerd wanneer het kanaal een tabelmodus inschakelt.
De IR opdelen (chunkMarkdownIR / renderMarkdownIRChunksWithinLimit)
- het splitsen gebeurt vóór het renderen op de IR-tekst, zodat inline stijlen en links per deel worden gesplitst in plaats van over een grens te worden afgebroken.
Per kanaal renderen (renderMarkdownWithMarkers) - een toewijzing van stijlmarkeringen zet bereiken om in de systeemeigen opmaak van het kanaal.

Kanaal	Renderer	Opmerkingen
Slack	mrkdwn-tokens (`bold`, `_italic_`, `code`, codeblokken met hekken)	Links worden `<url\|label>`; automatische links zijn tijdens het parseren uitgeschakeld om dubbele links te voorkomen
Telegram	HTML-tags (`<b>`, `<i>`, `<s>`, `<code>`, `<pre><code>`, `<a href>`, `<tg-spoiler>`)	Ondersteunt ook tabellen en koppen (`<h1>`-`<h6>`) in uitgebreide berichten wanneer `richMessages` is ingeschakeld
Signal	platte tekst + `text-style`-bereiken	Links worden als `label (url)` weergegeven wanneer het label afwijkt van de URL
Discord, WhatsApp, iMessage, Microsoft Teams en andere kanalen	platte tekst	Geen op IR gebaseerde stijl; Markdown-tabellen worden nog steeds omgezet via `convertMarkdownTables`

IR-voorbeeld

Invoer-Markdown: OC_I18N_900000 IR (schematisch): OC_I18N_900001

Tabelverwerking

markdown.tables bepaalt hoe een kanaal Markdown-tabellen omzet, per kanaal en optioneel per account:

Modus	Gedrag
`code`	Renderen als een uitgelijnde ASCII-tabel in een codeblok (standaardterugval)
`bullets`	Elke rij omzetten in opsommingstekens met `label: value`
`block`	Systeemeigen tabellen behouden waar het transport die ondersteunt; anders terugvallen op `code`
`off`	Het parseren van tabellen uitschakelen; de onbewerkte tabeltekst ongewijzigd doorgeven

Standaardwaarden van Plugins per kanaal: Signal, WhatsApp en Matrix gebruiken standaard bullets; Mattermost gebruikt standaard off; Telegram gebruikt standaard block (wat wordt omgezet naar code, tenzij voor het account richMessages is ingeschakeld). Elk kanaal zonder expliciete standaardwaarde van de Plugin valt terug op code. OC_I18N_900002

Regels voor opdelen

Deellimieten komen uit kanaaladapters/configuratie en gelden voor IR-tekst, niet voor gerenderde uitvoer.
Codeblokken met hekken worden als één blok behouden, met een afsluitende nieuwe regel zodat kanalen het afsluitende hek correct renderen.
Voorvoegsels van lijsten en blokcitaten maken deel uit van de IR-tekst, zodat het opdelen nooit midden in een voorvoegsel splitst.
Inline stijlen worden nooit over delen gesplitst; de renderer opent een nog geopende stijl opnieuw aan het begin van het volgende deel.

Zie Streamen en opdelen voor gedrag rond deelgrenzen en bezorging via kanalen.

Linkbeleid

Slack: [label](url) -> <url|label>; kale URL's blijven kaal.
Telegram: [label](url) -> <a href="url">label</a> (HTML-parseermodus).
Signal: [label](url) -> label (url), tenzij het label al overeenkomt met de URL.

Spoilers

Spoilermarkeringen (||spoiler||) worden geparseerd voor Signal (toegewezen aan stijlbereiken van SPOILER) en Telegram (toegewezen aan <tg-spoiler>). Andere kanalen behandelen ||...|| als platte tekst.

Een kanaalformatter toevoegen of bijwerken

Eén keer parseren met markdownToIR(...), waarbij kanaalgeschikte opties worden doorgegeven (autolink, headingStyle, blockquotePrefix, tableMode).
Renderen met renderMarkdownWithMarkers(...) en een toewijzing van stijlmarkeringen (of aangepaste logica voor stijlbereiken voor transporten zoals Signal).
Opdelen met chunkMarkdownIR(...) of renderMarkdownIRChunksWithinLimit(...) voordat elk deel wordt gerenderd.
De adapter koppelen zodat de nieuwe opdeler en renderer worden aangeroepen vanuit het uitgaande verzendpad.
Testen met opmaaktests plus een test voor uitgaande bezorging als het kanaal berichten opdeelt.

Veelvoorkomende valkuilen

Slack-tokens tussen punthaken (<@U123>, <#C123>, <https://...>) moeten het escapen overleven; onbewerkte HTML moet nog steeds veilig worden geëscapet.
Telegram-HTML vereist dat tekst buiten tags wordt geëscapet om ongeldige opmaak te voorkomen.
Signal-stijlbereiken gebruiken UTF-16-posities, geen codepuntposities.
Behoud afsluitende nieuwe regels bij codeblokken met hekken, zodat de afsluitende markering op een eigen regel terechtkomt.

Gerelateerd

Streamen en opdelen

Gedrag voor uitgaand streamen, deelgrenzen en kanaalspecifieke bezorging.

Systeemprompt

Wat het model vóór het gesprek ziet, inclusief geïnjecteerde werkruimtebestanden.

Was this useful?