Concept internals
Mise en forme Markdown
OpenClaw convertit le Markdown sortant en une représentation intermédiaire (IR) partagée avant de générer une sortie propre à chaque canal. L’IR conserve le texte brut ainsi que les plages de style et de liens, de sorte qu’une seule étape d’analyse alimente chaque canal et que le découpage ne scinde jamais la mise en forme au milieu d’une plage.
Pipeline
- Analyser le Markdown en IR (
markdownToIR) - texte brut avec plages de style (gras, italique, barré, code, bloc de code, divulgâcheur, citation, titres de niveau 1 à 6) et plages de liens. Les décalages sont exprimés en unités de code UTF-16 afin que les plages de style de Signal correspondent directement à son API. Les tableaux ne sont analysés que lorsque le canal active un mode de tableau. - Découper l’IR (
chunkMarkdownIR/renderMarkdownIRChunksWithinLimit)- le découpage s’effectue sur le texte de l’IR avant le rendu, de sorte que les styles intégrés et les liens sont répartis par fragment au lieu d’être rompus à une limite.
- Effectuer le rendu par canal (
renderMarkdownWithMarkers) - une table de correspondance des marqueurs de style transforme les plages en balisage natif du canal.
| Canal | Moteur de rendu | Remarques |
|---|---|---|
| Slack | jetons mrkdwn (*bold*, _italic_, `code`, blocs de code délimités) |
Les liens deviennent <url|label> ; les liens automatiques sont désactivés pendant l’analyse pour éviter les doublons |
| Telegram | balises HTML (<b>, <i>, <s>, <code>, <pre><code>, <a href>, <tg-spoiler>) |
Prend également en charge les tableaux et les titres des messages enrichis (<h1>-<h6>) lorsque richMessages est activé |
| Signal | texte brut + plages text-style |
Les liens sont rendus sous la forme label (url) lorsque le libellé diffère de l’URL |
| Discord, WhatsApp, iMessage, Microsoft Teams et autres canaux | texte brut | Aucun style basé sur l’IR ; la conversion des tableaux Markdown s’effectue toujours via convertMarkdownTables |
Exemple d’IR
Markdown d’entrée : OC_I18N_900000 IR (schématique) : OC_I18N_900001
Gestion des tableaux
markdown.tables détermine la manière dont un canal convertit les tableaux Markdown, pour chaque
canal et, facultativement, pour chaque compte :
| Mode | Comportement |
|---|---|
code |
Effectuer le rendu sous forme de tableau ASCII aligné dans un bloc de code (valeur de repli par défaut) |
bullets |
Convertir chaque ligne en éléments de liste label: value |
block |
Conserver les tableaux natifs lorsque le transport les prend en charge ; sinon, revenir à code |
off |
Désactiver l’analyse des tableaux ; le texte brut du tableau est transmis sans modification |
Valeurs par défaut des Plugins par canal : Signal, WhatsApp et Matrix utilisent
bullets par défaut ; Mattermost utilise off par défaut ; Telegram utilise block par défaut (qui
se résout en code, sauf si richMessages est activé pour le compte). Tout
canal sans valeur par défaut explicite définie par un Plugin revient à code.
OC_I18N_900002
Règles de découpage
- Les limites de fragment proviennent des adaptateurs ou de la configuration du canal et s’appliquent au texte de l’IR, et non à la sortie générée.
- Les blocs de code délimités sont conservés en un seul bloc avec un saut de ligne final afin que les canaux génèrent correctement le délimiteur de fermeture.
- Les préfixes de liste et de citation font partie du texte de l’IR, de sorte que le découpage ne scinde jamais un préfixe.
- Les styles intégrés ne sont jamais scindés entre plusieurs fragments ; le moteur de rendu rouvre un style actif au début du fragment suivant.
Consultez Diffusion en continu et découpage pour en savoir plus sur les limites de fragment et le comportement de distribution entre les canaux.
Politique relative aux liens
- Slack :
[label](url)-><url|label>; les URL brutes restent telles quelles. - Telegram :
[label](url)-><a href="url">label</a>(mode d’analyse HTML). - Signal :
[label](url)->label (url), sauf si le libellé correspond déjà à l’URL.
Divulgâcheurs
Les marqueurs de divulgâcheur (||spoiler||) sont analysés pour Signal (associés à des plages de style
SPOILER) et Telegram (associés à <tg-spoiler>). Les autres canaux traitent
||...|| comme du texte brut.
Ajouter ou mettre à jour le formateur d’un canal
- Analyser une seule fois avec
markdownToIR(...), en transmettant les options adaptées au canal (autolink,headingStyle,blockquotePrefix,tableMode). - Effectuer le rendu avec
renderMarkdownWithMarkers(...)et une table de correspondance des marqueurs de style (ou une logique personnalisée de plages de style pour les transports comme Signal). - Découper avec
chunkMarkdownIR(...)ourenderMarkdownIRChunksWithinLimit(...)avant d’effectuer le rendu de chaque fragment. - Connecter l’adaptateur afin d’appeler le nouveau découpeur et le nouveau moteur de rendu depuis le chemin d’envoi sortant.
- Tester avec des tests de format ainsi qu’un test de distribution sortante si le canal effectue un découpage.
Pièges courants
- Les jetons Slack entre chevrons (
<@U123>,<#C123>,<https://...>) doivent survivre à l’échappement ; le HTML brut doit toujours être échappé de manière sûre. - Le HTML Telegram exige l’échappement du texte situé hors des balises afin d’éviter un balisage incorrect.
- Les plages de style Signal utilisent des décalages UTF-16, et non des décalages en points de code.
- Conservez les sauts de ligne finaux des blocs de code délimités afin que le marqueur de fermeture se trouve sur sa propre ligne.
