Mantis

Mantis publie des preuves visuelles de CI et un commentaire de PR concernant le comportement d’OpenClaw. Les scénarios de transport en direct comparent une référence de base connue comme défectueuse à une référence candidate ; les parcours ciblés dans le navigateur peuvent plutôt valider un candidat par rapport à un transport simulé déterministe. Discord a été livré en premier avec une authentification réelle du bot, des canaux de serveur, des réactions, des fils de discussion et un témoin dans le navigateur. Il existe également des parcours Slack, Telegram et des parcours ciblés de discussion dans la Control UI ; WhatsApp et Matrix ne sont pas implémentés.

Responsabilités

OpenClaw (extensions/qa-lab/src/mantis/*) : environnement d’exécution des scénarios, CLI pnpm openclaw qa mantis <command>, schéma des preuves.
Laboratoire d’assurance qualité (extensions/qa-lab/src/live-transports/*) : banc de test du transport en direct, bots pilote/SUT, générateurs de rapports et de preuves.
Crabbox (openclaw/crabbox) : machines Linux préchauffées, baux, VNC, crabbox media preview.
GitHub Actions (.github/workflows/mantis-*.yml) : points d’entrée distants, conservation des artefacts.
ClawSweeper : analyse les commandes de PR des responsables, déclenche les workflows et publie le commentaire final sur la PR.

Commandes CLI

Toutes les commandes sont pnpm openclaw qa mantis <command>, définies dans extensions/qa-lab/src/mantis/cli.ts. Nécessite OPENCLAW_ENABLE_PRIVATE_QA_CLI=1 lors de la compilation et de l’exécution (les workflows intégrés définissent OPENCLAW_BUILD_PRIVATE_QA=1 et OPENCLAW_ENABLE_PRIVATE_QA_CLI=1 avant la compilation).

Commande	Objectif
`discord-smoke`	Vérifier que le bot Discord Mantis peut voir le serveur/canal, publier un message et ajouter une réaction.
`run`	Exécuter un scénario avant/après sur les références de base et candidate (Discord uniquement).
`desktop-browser-smoke`	Louer/réutiliser un bureau Crabbox, ouvrir un navigateur visible, capturer une capture d’écran et une vidéo.
`slack-desktop-smoke`	Louer/réutiliser un bureau Crabbox, y exécuter l’assurance qualité Slack, ouvrir Slack Web et capturer les preuves.
`telegram-desktop-builder`	Louer/réutiliser un bureau Crabbox, installer Telegram Desktop et, facultativement, configurer un Gateway OpenClaw.
`visual-task` / `visual-driver`	Capture générique d’un bureau Crabbox avec assertions facultatives de compréhension d’image ; `visual-driver` est la partie pilote lancée sous `crabbox record --while`.

Chaque commande accepte --repo-root <path> et --output-dir <path> ; les commandes Crabbox acceptent également --crabbox-bin, --provider, --machine-class/--class, --lease-id, --idle-timeout, --ttl et --keep-lease. Les valeurs par défaut de la CLI locale pour le fournisseur/la classe sont hetzner/beast, sauf indication contraire ; les workflows de CI remplacent généralement les deux.

`discord-smoke`

pnpm openclaw qa mantis discord-smoke \
  --output-dir .artifacts/qa-e2e/mantis/discord-smoke

Appelle l’API REST Discord (https://discord.com/api/v10) pour récupérer l’utilisateur du bot, le serveur, les canaux du serveur et le canal cible, vérifie que le canal appartient au serveur, puis (sauf avec --skip-post) publie un message et ajoute une réaction 👀. Écrit mantis-discord-smoke-summary.json et mantis-discord-smoke-report.md. Ordre de résolution du jeton : valeur de --token-file, puis OPENCLAW_QA_DISCORD_MANTIS_BOT_TOKEN (remplacement avec --token-env), puis un fichier nommé par OPENCLAW_QA_DISCORD_MANTIS_BOT_TOKEN_FILE (remplacement avec --token-file-env). Les identifiants du serveur/canal proviennent de OPENCLAW_QA_DISCORD_GUILD_ID / OPENCLAW_QA_DISCORD_CHANNEL_ID (remplacement avec --guild-id / --channel-id) et doivent être des snowflakes Discord de 17 à 20 chiffres. Définissez OPENCLAW_QA_REDACT_PUBLIC_METADATA=1 pour remplacer les identifiants et les noms du bot, du serveur, du canal et du message par <redacted> dans le résumé et le rapport publiés.

`run`

pnpm openclaw qa mantis run \
  --transport discord \
  --scenario discord-status-reactions-tool-only \
  --baseline origin/main \
  --candidate HEAD \
  --output-dir .artifacts/qa-e2e/mantis/local-discord-status-reactions

--transport n’accepte actuellement que discord. --scenario est l’un des deux identifiants intégrés, chacun possédant sa propre référence de base par défaut et ses propres libellés avant/après attendus (extensions/qa-lab/src/mantis/run.runtime.ts) :

Scénario	Référence de base par défaut	Résultat attendu de la base	Résultat attendu du candidat
`discord-status-reactions-tool-only`	`0bf06e953fdda290799fc9fb9244a8f67fdae593`	`queued-only`	`queued -> thinking -> done`
`discord-thread-reply-filepath-attachment`	`81349cdc2a9d5143fd0991ed858b739e7d96e05c`	la réponse dans le fil omet la pièce jointe `filePath`	la réponse dans le fil l’inclut

--candidate utilise par défaut HEAD. Autres options : --credential-source (valeur par défaut convex), --credential-role (valeur par défaut ci), --provider-mode (valeur par défaut live-frontier), --fast (activé par défaut), --skip-install, --skip-build. L’exécuteur crée des copies de travail git worktree détachées pour la base et le candidat sous <output-dir>/worktrees/, exécute pnpm install/pnpm build dans chacune (sauf si cette étape est ignorée), puis exécute pnpm openclaw qa discord --scenario <id> --model openai/gpt-5.4 --alt-model openai/gpt-5.4 --allow-failures sur chaque arborescence de travail. Chaque parcours écrit discord-qa-reaction-timelines.json ainsi qu’une paire <scenario-id>-timeline.html/.png ; l’exécuteur recopie ces preuves sous baseline//candidate/, écrit comparison.json, mantis-report.md et mantis-evidence.json dans le répertoire de sortie, et se termine avec un code différent de zéro si la comparaison n’a pas réussi (base fail et candidat pass). Le second scénario Discord (discord-thread-reply-filepath-attachment) publie un message parent avec le bot pilote, crée un véritable fil de discussion, appelle l’action message.thread-reply du SUT avec un filePath local au dépôt, puis interroge régulièrement le fil pour obtenir la réponse et le nom de fichier de la pièce jointe. Il attend une pièce jointe nommée mantis-thread-report.md.

`desktop-browser-smoke`

pnpm openclaw qa mantis desktop-browser-smoke \
  --output-dir .artifacts/qa-e2e/mantis/desktop-browser

Loue ou réutilise un bureau Crabbox, lance un navigateur dans la session VNC pointant vers --browser-url (valeur par défaut https://openclaw.ai) ou un --html-file rendu, attend, effectue une capture d’écran avec scrot, enregistre facultativement un MP4 avec ffmpeg, puis synchronise desktop-browser-smoke.png / .mp4 / remote-metadata.json vers --output-dir avec rsync. Options :

--lease-id <cbx_...> réutilise un bureau préchauffé au lieu d’en créer un.
--browser-profile-dir <remote-path> réutilise un répertoire distant de données utilisateur Chrome afin qu’un bureau persistant reste connecté entre les exécutions (utilisé pour un profil d’observation Discord Web de longue durée).
--browser-profile-archive-env <name> restaure depuis cette variable d’environnement une archive de profil Chrome .tgz encodée en base64 avant le lancement (valeur par défaut OPENCLAW_MANTIS_BROWSER_PROFILE_TGZ_B64) ; utilisé pour les témoins connectés tels que Discord Web.
--video-duration <seconds> contrôle la durée de la capture MP4 (valeur par défaut 10 s).
--keep-lease (ou OPENCLAW_MANTIS_KEEP_VM=1) maintient ouvert pour inspection VNC un bail créé lors de cette exécution ; les exécutions ayant échoué après avoir créé un bail le conservent également par défaut.

Pour les preuves Discord Web, Mantis utilise un compte d’observation dédié, et non un jeton de bot. L’oracle REST Discord (via qa discord) reste la référence ; lorsque OPENCLAW_QA_DISCORD_CAPTURE_UI_METADATA=1 est défini, le scénario écrit également un artefact d’URL Discord Web, et OPENCLAW_QA_DISCORD_KEEP_THREADS=1 laisse le fil ouvert assez longtemps pour que le navigateur puisse l’ouvrir. Le workflow GitHub privilégie un profil d’observation persistant via MANTIS_DISCORD_VIEWER_CHROME_PROFILE_DIR (les archives complètes de profil peuvent dépasser la limite de taille des secrets GitHub) ; pour les petits profils ou les profils d’amorçage, il peut restaurer à la place un .tgz encodé en base64 depuis MANTIS_DISCORD_VIEWER_CHROME_PROFILE_TGZ_B64. Si aucune source n’est configurée, le workflow publie tout de même les captures d’écran déterministes de la base et du candidat et consigne que le témoin connecté a été ignoré.

`slack-desktop-smoke`

pnpm openclaw qa mantis slack-desktop-smoke \
  --output-dir .artifacts/qa-e2e/mantis/slack-desktop \
  --gateway-setup \
  --scenario slack-canary \
  --keep-lease

Loue ou réutilise un bureau Crabbox, synchronise la copie de travail dans la VM, exécute pnpm openclaw qa slack à l’intérieur, ouvre Slack Web dans le navigateur VNC, capture le bureau et recopie localement les artefacts d’assurance qualité Slack (slack-qa/) ainsi que la capture d’écran/vidéo VNC. Il s’agit de la seule configuration Mantis où le Gateway du SUT et le navigateur s’exécutent tous deux dans la même VM. Avec --gateway-setup, la commande crée un répertoire personnel OpenClaw jetable et persistant dans $HOME/.openclaw-mantis/slack-openclaw sur la VM, adapte la configuration Slack Socket Mode au canal cible, démarre openclaw gateway run --dev --allow-unconfigured --port 38973 et laisse Chrome s’exécuter dans la session VNC ; l’omission de --gateway-setup exécute à la place le parcours normal d’assurance qualité Slack de bot à bot. Variables d’environnement requises pour --credential-source env (la valeur locale par défaut est env ; le rôle par défaut est maintainer) :

OPENCLAW_QA_SLACK_CHANNEL_ID
OPENCLAW_QA_SLACK_DRIVER_BOT_TOKEN
OPENCLAW_QA_SLACK_SUT_BOT_TOKEN
OPENCLAW_QA_SLACK_SUT_APP_TOKEN
OPENCLAW_LIVE_OPENAI_KEY pour le parcours du modèle distant (si seul OPENAI_API_KEY est défini localement, Mantis le copie vers OPENCLAW_LIVE_OPENAI_KEY avant d’appeler Crabbox)

Avec --credential-source convex, Mantis loue les identifiants du SUT Slack depuis le pool partagé avant de créer la VM et transmet l’identifiant du canal, le jeton d’application et le jeton de bot à la VM sous forme de variables d’environnement OPENCLAW_MANTIS_SLACK_*, de sorte que les workflows GitHub n’ont besoin que du secret du courtier Convex, et non des jetons Slack bruts. Autres options : --slack-url <url> ouvre une URL spécifique (sinon Mantis dérive https://app.slack.com/client/<team>/<channel> de auth.test) ; --slack-channel-id <id> définit le canal de la liste d’autorisation du Gateway ; OPENCLAW_MANTIS_SLACK_BROWSER_PROFILE_DIR contrôle le profil Chrome persistant dans la VM (valeur par défaut $HOME/.config/openclaw-mantis/slack-chrome-profile) ; --approval-checkpoints exécute les scénarios natifs d’approbation Slack (slack-approval-exec-native, slack-approval-plugin-native) et génère des captures d’écran des points de contrôle en attente/résolus au lieu de configurer le Gateway (incompatible avec --gateway-setup) ; --hydrate-mode source|prehydrated, --provider-mode, --model, --alt-model et --fast sont transmis au parcours Slack en direct. Les captures d’écran des points de contrôle d’approbation sont générées à partir du message de l’API Slack observé par le scénario, et non depuis l’interface Slack en direct ; slack-desktop-smoke.png constitue uniquement une preuve de Slack Web si le profil du navigateur du bail était déjà connecté.

`telegram-desktop-builder`

pnpm openclaw qa mantis telegram-desktop-builder \
  --credential-source convex \
  --credential-role maintainer \
  --keep-lease

Loue ou réutilise un bureau Crabbox, installe l’application Linux native Telegram Desktop, restaure facultativement une archive de session utilisateur, configure OpenClaw avec le jeton du bot SUT Telegram loué, démarre openclaw gateway run --dev --allow-unconfigured --port 38974, publie un message de disponibilité du bot pilote dans le groupe privé loué, puis capture une capture d’écran et un MP4. Un jeton de bot configure uniquement OpenClaw ; il ne connecte jamais Telegram Desktop. L’observateur du bureau est une session utilisateur Telegram distincte, restaurée depuis --telegram-profile-archive-env <name> ou connectée manuellement via VNC et maintenue active avec --keep-lease. Options : --lease-id <cbx_...> relance l’exécution sur une VM déjà connectée à Telegram Desktop ; --telegram-profile-archive-env <name> restaure une archive de profil .tgz encodée en base64 avant le lancement ; --telegram-profile-dir <remote-path> définit le répertoire distant du profil (valeur par défaut $HOME/.local/share/TelegramDesktop) ; --no-gateway-setup installe et ouvre uniquement Telegram Desktop ; --credential-source/--credential-role utilisent par défaut convex/maintainer.

Manifeste des preuves

Chaque scénario qui publie dans une PR écrit mantis-evidence.json à côté de son rapport :

{
  "schemaVersion": 1,
  "id": "discord-status-reactions",
  "title": "QA des réactions de statut Discord de Mantis",
  "summary": "Résumé principal lisible par un humain pour le commentaire de PR.",
  "scenario": "discord-status-reactions-tool-only",
  "comparison": {
    "baseline": { "sha": "...", "status": "fail", "expected": "queued-only" },
    "candidate": { "sha": "...", "status": "pass", "expected": "queued -> thinking -> done" },
    "pass": true
  },
  "artifacts": [
    {
      "kind": "timeline",
      "lane": "baseline",
      "label": "Référence avec mise en file d’attente uniquement",
      "path": "baseline/timeline.png",
      "targetPath": "baseline.png",
      "alt": "Chronologie Discord de référence",
      "width": 420
    }
  ]
}

Le path de l’artefact est relatif au répertoire du manifeste ; targetPath est relatif au préfixe d’artefact R2/S3 configuré. scripts/mantis/publish-pr-evidence.mjs refuse la traversée de chemins et ignore les entrées avec "required": false lorsque le fichier est absent. Types d’artefacts : timeline (capture d’écran avant/après déterministe), desktopScreenshot (capture d’écran VNC/navigateur), motionPreview (GIF animé intégré issu de l’enregistrement), motionClip (MP4 élagué selon les mouvements), fullVideo (enregistrement complet), metadata (fichier annexe JSON/journal), report (rapport Markdown). Disposition des artefacts d’une exécution sur le disque :

.artifacts/qa-e2e/mantis/<run-id>/
  mantis-report.md
  mantis-evidence.json
  baseline/
  candidate/
  comparison.json

Les captures d’écran constituent des preuves, pas des secrets, mais exigent tout de même une discipline de caviardage : des noms de canaux privés, des noms d’utilisateur ou le contenu de messages peuvent apparaître. Définissez OPENCLAW_QA_REDACT_PUBLIC_METADATA=1 pour les téléversements publics d’artefacts ; cette option est activée par défaut dans les workflows GitHub de Discord/Slack/Telegram.

Automatisation GitHub

scripts/mantis/publish-pr-evidence.mjs est l’outil de publication réutilisable. Les workflows l’appellent avec le manifeste, la PR cible, la racine cible des artefacts, le marqueur de commentaire, l’URL des artefacts, l’URL de l’exécution et la source de la requête. Il téléverse les artefacts déclarés dans le compartiment R2 de Mantis, génère un commentaire de PR commençant par un résumé avec des images/aperçus intégrés et des vidéos liées, puis met à jour le commentaire de marqueur existant ou en crée un nouveau. Variables d’environnement requises :

MANTIS_ARTIFACT_R2_ACCESS_KEY_ID
MANTIS_ARTIFACT_R2_SECRET_ACCESS_KEY
MANTIS_ARTIFACT_R2_BUCKET (les workflows définissent openclaw-crabbox-artifacts)
MANTIS_ARTIFACT_R2_ENDPOINT
MANTIS_ARTIFACT_R2_REGION (les workflows définissent auto)
MANTIS_ARTIFACT_R2_PUBLIC_BASE_URL (les workflows définissent https://artifacts.openclaw.ai)

Les commentaires sont publiés par l’application GitHub Mantis (MANTIS_GITHUB_APP_ID / MANTIS_GITHUB_APP_PRIVATE_KEY), et non par github-actions[bot], en utilisant un commentaire marqueur masqué comme clé d’insertion ou de mise à jour.

Workflow	Déclencheur	Fonction
`Mantis Discord Smoke`	déclenchement manuel	Exécute `discord-smoke` sur une référence choisie.
`Mantis Discord Status Reactions`	commentaire de PR ou déclenchement manuel	Crée des worktrees distincts pour la référence et le candidat, exécute `discord-status-reactions-tool-only` sur chacun, affiche la chronologie de chaque voie dans un navigateur de bureau Crabbox, génère des aperçus GIF/MP4 élagués selon les mouvements avec `crabbox media preview`, téléverse les artefacts et publie les preuves intégrées dans la PR.
`Mantis Scenario`	déclenchement manuel	Répartiteur générique : accepte `scenario_id` (`discord-status-reactions-tool-only`, `discord-thread-reply-filepath-attachment`, `slack-desktop-smoke`, `telegram-live`, `telegram-desktop-proof`, `web-ui-chat-proof`), `baseline_ref`, `candidate_ref`, `pr_number`, puis les transmet au workflow du scénario correspondant.
`Mantis Slack Desktop Smoke`	déclenchement manuel	Réserve un bureau Linux Crabbox (par défaut `aws`, avec `hetzner` au choix), exécute `slack-desktop-smoke --gateway-setup` sur le candidat, enregistre le bureau, génère un aperçu des mouvements, téléverse les artefacts et publie les preuves dans la PR lorsqu’un numéro de PR est fourni.
`Mantis Telegram Live`	commentaire de PR ou déclenchement manuel	Exécute la voie de QA Telegram en direct via l’API de bot (`openclaw qa telegram`), écrit `mantis-evidence.json` à partir du résumé de QA, affiche le HTML de preuve caviardé dans un navigateur de bureau Crabbox, génère un GIF des mouvements et publie les preuves dans la PR. La connexion à Telegram Web n’est pas requise pour cette voie.
`Mantis Telegram Desktop Proof`	étiquette de PR du mainteneur (`mantis: telegram-visible-proof`) plus commentaire de PR, ou déclenchement manuel	Preuve agentique avant/après avec l’application native Telegram Desktop. Transmet la PR, les références de base/candidate et les instructions du mainteneur à Codex, qui exécute la voie de preuve Crabbox avec Telegram Desktop et un utilisateur réel pour les deux références, puis publie un tableau de preuves à 2 colonnes dans la PR.
`Mantis Web UI Chat Proof`	commentaire de PR ou déclenchement manuel	Exécute la preuve Playwright ciblée du chat de l’interface de contrôle OpenClaw sur le candidat, vérifie que le navigateur envoie les données via le Gateway simulé, capture les artefacts de capture d’écran/vidéo et publie les preuves dans la PR. Cette voie prouve uniquement le chat Web, pas WinUI, une application native ni une preuve visuelle arbitraire.

Mantis Discord Status Reactions et Mantis Telegram Live acceptent tous deux baseline_ref/candidate_ref (ou baseline=/candidate= dans un commentaire de PR) et vérifient que le SHA résolu est soit un ancêtre de origin/main, soit une étiquette de version (v*), soit la tête d’une PR ouverte avant l’exécution avec des identifiants contenant des secrets. Déclencheurs par commentaire, depuis une PR avec un accès en écriture/maintenance/administration :

@openclaw-mantis discord status reactions
@openclaw-mantis discord status reactions baseline=origin/main candidate=HEAD
@openclaw-mantis telegram
@openclaw-mantis telegram scenario=telegram-status-command
@openclaw-mantis telegram scenarios=telegram-status-command,channel-canary
@openclaw-mantis web ui chat
@openclaw-mantis web-ui-chat candidate=HEAD

Les déclencheurs Telegram par commentaire utilisent par défaut le SHA de tête de la PR comme candidat et telegram-status-command comme scénario ; ils acceptent provider=aws|hetzner et lease=<cbx_...> pour cibler un fournisseur Crabbox particulier ou un bureau préchauffé. Mantis Telegram Desktop Proof ne répond à un commentaire de PR que lorsque la PR porte déjà l’étiquette mantis: telegram-visible-proof. Les déclencheurs du chat de l’interface Web par commentaire utilisent par défaut le SHA de tête de la PR comme candidat. Ils exécutent la preuve du chat de l’interface de contrôle avec Gateway simulé et publient les artefacts du navigateur ; utilisez une preuve Playwright/navigateur normale, des captures d’écran du mainteneur, Crabbox ou des artefacts locaux pour les autres pages Web et les surfaces d’applications natives. ClawSweeper peut également déclencher directement un scénario :

@clawsweeper mantis discord discord-status-reactions-tool-only

Machines et secrets

Les valeurs par défaut de Crabbox pour la CLI locale sont --provider hetzner --class beast ; remplacez-les avec --provider, --class/--machine-class, ou OPENCLAW_MANTIS_CRABBOX_PROVIDER / OPENCLAW_MANTIS_CRABBOX_CLASS. Les workflows GitHub remplacent généralement les deux (par exemple --class standard, ainsi que l’entrée de choix du fournisseur aws/hetzner du workflow Slack). Si un fournisseur est trop lent ou indisponible, ajoutez-le derrière la même interface Crabbox au lieu de coder en dur une solution de repli. Configuration de référence de la VM : Linux avec Chrome/Chromium compatible avec un environnement de bureau, accès CDP, VNC/ noVNC, Node 22.22.3+, 24.15+ ou 25.9+ et pnpm, une extraction d’OpenClaw, ainsi qu’un accès sortant au transport cible, à GitHub, aux fournisseurs de modèles et au courtier d’identifiants. Noms des identifiants et variables d’environnement utilisés dans les commandes et workflows Mantis :

OPENCLAW_QA_DISCORD_MANTIS_BOT_TOKEN
OPENCLAW_QA_DISCORD_GUILD_ID
OPENCLAW_QA_DISCORD_CHANNEL_ID
L’exécution locale de qa mantis run --credential-source env nécessite également OPENCLAW_QA_DISCORD_DRIVER_BOT_TOKEN, OPENCLAW_QA_DISCORD_SUT_BOT_TOKEN et OPENCLAW_QA_DISCORD_SUT_APPLICATION_ID. Les workflows GitHub utilisent normalement --credential-source convex et les identifiants du courtier ci-dessous à la place des jetons bruts de bot Discord.
OPENCLAW_QA_REDACT_PUBLIC_METADATA=1 pour les téléversements publics d’artefacts
OPENCLAW_QA_CONVEX_SITE_URL, OPENCLAW_QA_CONVEX_SECRET_CI
OPENAI_API_KEY (ou la valeur propre à la preuve Telegram Desktop OPENCLAW_MANTIS_AGENT_OPENAI_API_KEY)
CRABBOX_COORDINATOR / CRABBOX_COORDINATOR_TOKEN (les workflows acceptent également OPENCLAW_QA_MANTIS_CRABBOX_COORDINATOR / _TOKEN comme solution de repli et les associent aux noms simples avant d’appeler Crabbox)
CRABBOX_ACCESS_CLIENT_ID, CRABBOX_ACCESS_CLIENT_SECRET
MANTIS_GITHUB_APP_ID, MANTIS_GITHUB_APP_PRIVATE_KEY

L’exécuteur Mantis ne doit jamais afficher les jetons de bot Discord/Slack/Telegram, les clés d’API des fournisseurs, les cookies du navigateur, le contenu des profils d’authentification, les mots de passe VNC ni les charges utiles brutes des identifiants. Si un jeton fuit dans un ticket, une PR, une discussion ou un journal, faites-le pivoter après avoir enregistré le secret de remplacement.

Résultats d’exécution

Les scénarios de transport avant/après distinguent les résultats suivants afin qu’un environnement instable ne soit pas interprété comme une régression du produit :

Bug reproduit : la référence a échoué de la manière attendue par le scénario.
Échec du harnais : la configuration de l’environnement, les identifiants, l’API de transport, le navigateur ou le fournisseur a échoué avant que l’oracle ne soit pertinent.

La preuve de navigateur portant uniquement sur le candidat indique si celui-ci a satisfait les assertions du Gateway simulé et de l’interface visible ; elle ne prétend pas reproduire le comportement de référence.

Ajout d’un scénario

Les scénarios de transport en direct sont définis en TypeScript pour chaque transport (voir MANTIS_SCENARIO_CONFIGS dans extensions/qa-lab/src/mantis/run.runtime.ts pour la structure avant/après de Discord), et non dans un format de fichier déclaratif autonome. Chaque scénario nécessite : un identifiant et un titre, le transport, les identifiants requis, la stratégie de référence de base, la stratégie de référence candidate, le correctif de configuration OpenClaw, les étapes de configuration/stimulation, l’oracle attendu pour la référence et le candidat, les cibles de capture visuelle, le budget de délai d’expiration et les étapes de nettoyage. La preuve ciblée du navigateur portant uniquement sur le candidat peut utiliser un test E2E déterministe dédié et un workflow. Gardez sa portée explicite, validez la référence candidate avant l’exécution, isolez la publication adossée à des secrets et produisez le même contrat de manifeste de preuves. Préférez de petits oracles typés aux vérifications visuelles : état des réactions Discord ou références de messages, état de l’API de fil de discussion ts/réaction Slack, identifiants et en-têtes de messages électroniques. Utilisez des captures d’écran du navigateur lorsque l’interface est le seul élément observable fiable, et conservez les vérifications visuelles comme complément d’un oracle d’API de plateforme lorsqu’il en existe un. Après Discord, Slack et Telegram, la même structure d’exécution s’étend à WhatsApp (connexion par code QR, réidentification, livraison, médias, réactions) et Matrix (salons chiffrés, relations de fil/réponse, reprise après redémarrage) ; aucun des deux n’est encore implémenté.

Questions ouvertes

Quel bot Discord doit servir de pilote et lequel de système sous test lorsque le bot Mantis existant est réutilisé ?
Pendant combien de temps GitHub doit-il conserver les artefacts Mantis pour les PR ?
Quand ClawSweeper doit-il recommander automatiquement un scénario Mantis plutôt que d’attendre une commande d’un mainteneur ?
Les captures d’écran doivent-elles être expurgées ou recadrées avant leur téléversement pour les PR publiques ?

Maturity

Testing and CI

Responsabilités

Commandes CLI

`discord-smoke`

`run`

`desktop-browser-smoke`

`slack-desktop-smoke`

`telegram-desktop-builder`

Manifeste des preuves

Automatisation GitHub

Machines et secrets

Résultats d’exécution

Ajout d’un scénario

Questions ouvertes

​Responsabilités

​Commandes CLI

​discord-smoke

​run

​desktop-browser-smoke

​slack-desktop-smoke

​telegram-desktop-builder

​Manifeste des preuves

​Automatisation GitHub

​Machines et secrets

​Résultats d’exécution

​Ajout d’un scénario

​Questions ouvertes

Responsabilités

Commandes CLI

`discord-smoke`

`run`

`desktop-browser-smoke`

`slack-desktop-smoke`

`telegram-desktop-builder`

Manifeste des preuves

Automatisation GitHub

Machines et secrets

Résultats d’exécution

Ajout d’un scénario

Questions ouvertes