Skip to main content

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.

Mantis Slack desktop-QA is de real-UI-lane voor bugs van Slack-klasse die een Linux-desktop, VNC-redding, Slack Web, een echte OpenClaw gateway, screenshots, video’s en een PR-bewijscommentaar nodig hebben. Gebruik dit wanneer unit tests of de headless Slack live-lane de bug niet kunnen bewijzen.

​
Opslagmodel

Mantis gebruikt drie verschillende opslaglagen:
  • Provider-image: eigendom van Crabbox en opgeslagen in het cloudprovideraccount. Deze bevat machinecapaciteiten zoals Chrome/Chromium, ffmpeg, scrot, Node/corepack/pnpm, native buildtools en lege cachemappen.
  • Warme lease-status: eigendom van de huidige operatorsessie. Deze kan een ingelogd browserprofiel, /var/cache/crabbox/pnpm en een voorbereide source checkout bevatten zolang de lease actief is.
  • Mantis-artefacten: eigendom van de OpenClaw-run. Ze staan onder .artifacts/qa-e2e/mantis/..., waarna GitHub Actions ze uploadt en de Mantis GitHub App inline bewijs op de PR plaatst.
Plaats nooit geheimen, browsercookies, Slack-inlogstatus, repository-checkouts, node_modules of dist/ in een vooraf gebakken provider-image.

​
GitHub-dispatch

Voer de workflow uit vanaf main: 
gh workflow run mantis-slack-desktop-smoke.yml \
  --ref main \
  -f candidate_ref=<trusted-ref-or-sha> \
  -f pr_number=<pr-number> \
  -f scenario_id=slack-canary \
  -f crabbox_provider=aws \
  -f keep_vm=false \
  -f hydrate_mode=source
Toegestane candidate_ref-waarden zijn bewust smal omdat de workflow live-referenties gebruikt: huidige main-afstamming, releasetags of een open PR-head van openclaw/openclaw. De workflow schrijft:
  • geüpload artefact: mantis-slack-desktop-smoke-<run-id>-<attempt>;
  • inline PR-commentaar van de Mantis GitHub App;
  • slack-desktop-smoke.png;
  • slack-desktop-smoke.mp4;
  • slack-desktop-smoke-preview.gif;
  • slack-desktop-smoke-change.mp4;
  • mantis-slack-desktop-smoke-summary.json;
  • mantis-slack-desktop-smoke-report.md;
  • externe logs zoals slack-desktop-command.log, openclaw-gateway.log, chrome.log en ffmpeg.log.
Het PR-commentaar wordt ter plekke bijgewerkt via de verborgen <!-- mantis-slack-desktop-smoke -->-markering.

​
Lokale CLI

Koud source-bewijs: 
pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --class standard \
  --gateway-setup \
  --credential-source convex \
  --credential-role maintainer \
  --provider-mode live-frontier \
  --model openai/gpt-5.4 \
  --alt-model openai/gpt-5.4 \
  --scenario slack-canary \
  --hydrate-mode source
Behoud de VM voor VNC-redding: 
pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --class standard \
  --gateway-setup \
  --scenario slack-canary \
  --keep-lease
Open VNC: 
crabbox vnc --provider aws --id <cbx_id> --open
Hergebruik een warme lease: 
pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --lease-id <cbx_id-or-slug> \
  --gateway-setup \
  --scenario slack-canary \
  --hydrate-mode source
Gebruik --hydrate-mode prehydrated alleen wanneer de hergebruikte externe werkruimte al node_modules en een gebouwde dist/ heeft. Mantis faalt gesloten als die ontbreken.

​
Hydratatiemodi

ModusGebruik wanneerExtern gedragAfweging
sourceNormaal PR-bewijs, koude machines, CIVoert pnpm install --frozen-lockfile --prefer-offline en pnpm build uit in de VMTraagst, sterkste source-checkout-bewijs
prehydratedJe bewust een hergebruikte lease voorbereiddeVereist bestaande node_modules en dist/; slaat install/build overSnel, maar alleen geldig voor door de operator beheerde warme leases
GitHub Actions bereidt de kandidaat-checkout altijd voor vóór de VM-run. De pnpm-store wordt gecachet op OS, Node-versie en lockfile. De VM-source-run gebruikt ook /var/cache/crabbox/pnpm wanneer aanwezig.

​
Timinginterpretatie

mantis-slack-desktop-smoke-report.md bevat fasetimings:
  • crabbox.warmup: cloudprovider-boot, desktop-/browsergereedheid en SSH.
  • crabbox.inspect: opzoeken van lease-metadata.
  • credentials.prepare: verkrijgen van een Convex-referentielease.
  • crabbox.remote_run: synchronisatie, browserstart, OpenClaw install/build of hydratatievalidatie, Gateway-start, screenshot en video-opname.
  • artifacts.copy: rsync terug vanaf de VM.
crabbox.remote_run kan als accepted worden gemarkeerd wanneer Crabbox een niet-nul externe status teruggeeft nadat Mantis metadata heeft gekopieerd die bewijst dat de OpenClaw Gateway actief is en de setup is voltooid. Behandel accepted als geslaagd-met-uitleg, niet als een mislukt scenario. Als de run traag is:
  • warmup domineert: bak vooraf of promoot een betere Crabbox provider-image;
  • remote_run domineert in source: gebruik een warme lease, verbeter hergebruik van de pnpm-store, of verplaats machinevereisten naar de provider-image;
  • remote_run domineert in prehydrated: de externe werkruimte was niet echt klaar, of de Gateway/browser/Slack-setup is traag;
  • artefactkopie domineert: inspecteer videogrootte en de inhoud van de artefactmap.

​
Bewijschecklist

Een goed PR-commentaar moet tonen:
  • scenario-id en kandidaat-SHA;
  • GitHub Actions-run-URL;
  • artefact-URL;
  • inline screenshot;
  • inline geanimeerde preview wanneer beschikbaar;
  • volledige MP4- en ingekorte MP4-links;
  • pass/fail-status;
  • timingsamenvatting in het bijgevoegde rapport.
Commit geen screenshots of video’s naar de repository. Bewaar ze in GitHub Actions-artefacten of het PR-commentaar.

​
Foutafhandeling

Als de workflow faalt vóór de VM-run, inspecteer dan eerst de Actions-job. Typische oorzaken zijn een niet-vertrouwde candidate_ref, ontbrekende omgevingsgeheimen of een mislukte install/build van de kandidaat. Als de VM-run faalt maar screenshots zijn teruggekopieerd, inspecteer: 
cat mantis-slack-desktop-smoke-report.md
cat mantis-slack-desktop-smoke-summary.json
cat slack-desktop-command.log
cat openclaw-gateway.log
cat chrome.log
cat ffmpeg.log
Als de run de lease heeft behouden, open dan VNC met de crabbox vnc ...-opdracht uit het rapport. Stop de lease wanneer je klaar bent: 
crabbox stop --provider aws <cbx_id-or-slug>
Als de Slack-login is verlopen, herstel die dan in VNC op een behouden lease en voer opnieuw uit met --lease-id. Bak dat browserprofiel niet in een provider-image.

​
Gerelateerd