--- read_when: - Ejecutar QA de escritorio de Mantis Slack desde GitHub o localmente - Depuración de ejecuciones lentas de Mantis Slack en escritorio - Elegir el modo de origen, prehidratado o de arrendamiento en caliente - Publicar evidencia de capturas de pantalla y video en una PR summary: 'Manual operativo para la QA de escritorio de Mantis Slack: despacho de GitHub, CLI local, concesiones VNC precalentadas, modos de hidratación, interpretación de tiempos, artefactos y gestión de fallos.' title: Guía operativa de Mantis Slack para escritorio x-i18n: generated_at: "2026-05-06T05:30:43Z" model: gpt-5.5 provider: openai source_hash: 83ca8792b53e5b14e592c2cbec6f6adfc936834e19f340f8e5eb3d467ecd3209 source_path: concepts/mantis-slack-desktop-runbook.md workflow: 16 --- Mantis Slack desktop QA es el carril de interfaz real para errores de clase Slack que necesitan un escritorio Linux, rescate por VNC, Slack Web, un Gateway real de OpenClaw, capturas de pantalla, videos y un comentario de evidencia en el PR. Úsalo cuando las pruebas unitarias o el carril live de Slack sin interfaz gráfica no puedan demostrar el error. ## Modelo de almacenamiento Mantis usa tres capas de almacenamiento diferentes: - Imagen del proveedor: propiedad de Crabbox y almacenada en la cuenta del proveedor de nube. Contiene capacidades de máquina como Chrome/Chromium, ffmpeg, scrot, Node/corepack/pnpm, herramientas de compilación nativas y directorios de caché vacíos. - Estado de lease caliente: propiedad de la sesión actual del operador. Puede contener un perfil de navegador con sesión iniciada, `/var/cache/crabbox/pnpm` y un checkout de código fuente preparado mientras el lease esté activo. - Artefactos de Mantis: propiedad de la ejecución de OpenClaw. Viven bajo `.artifacts/qa-e2e/mantis/...`; luego GitHub Actions los sube y la Mantis GitHub App comenta evidencia inline en el PR. Nunca coloques secretos, cookies del navegador, estado de inicio de sesión de Slack, checkouts de repositorio, `node_modules` ni `dist/` en una imagen prebakeada del proveedor. ## Dispatch de GitHub Ejecuta el workflow desde `main`: ```bash gh workflow run mantis-slack-desktop-smoke.yml \ --ref main \ -f candidate_ref= \ -f pr_number= \ -f scenario_id=slack-canary \ -f crabbox_provider=aws \ -f keep_vm=false \ -f hydrate_mode=source ``` Los valores permitidos de `candidate_ref` son intencionalmente limitados porque el workflow usa credenciales live: la ascendencia actual de `main`, etiquetas de release o la cabeza de un PR abierto desde `openclaw/openclaw`. El workflow escribe: - artefacto subido: `mantis-slack-desktop-smoke--`; - comentario inline en el PR desde la 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`; - logs remotos como `slack-desktop-command.log`, `openclaw-gateway.log`, `chrome.log` y `ffmpeg.log`. El comentario del PR se actualiza en el mismo lugar mediante el marcador oculto ``. ## CLI local Prueba de código fuente en frío: ```bash 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 ``` Mantén la VM para rescate por VNC: ```bash pnpm openclaw qa mantis slack-desktop-smoke \ --provider aws \ --class standard \ --gateway-setup \ --scenario slack-canary \ --keep-lease ``` Abre VNC: ```bash crabbox vnc --provider aws --id --open ``` Reutiliza un lease caliente: ```bash pnpm openclaw qa mantis slack-desktop-smoke \ --provider aws \ --lease-id \ --gateway-setup \ --scenario slack-canary \ --hydrate-mode source ``` Usa `--hydrate-mode prehydrated` solo cuando el workspace remoto reutilizado ya tenga `node_modules` y un `dist/` compilado. Mantis falla de forma cerrada si faltan. ## Modos de hidratación | Modo | Úsalo cuando | Comportamiento remoto | Compensación | | ------------- | ----------------------------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------- | | `source` | Prueba normal de PR, máquinas frías, CI | Ejecuta `pnpm install --frozen-lockfile --prefer-offline` y `pnpm build` dentro de la VM | El más lento, la prueba más sólida de checkout de código fuente | | `prehydrated` | Preparaste intencionalmente un lease reutilizado | Requiere `node_modules` y `dist/` existentes; omite install/build | Rápido, pero solo válido para leases calientes controlados por el operador | GitHub Actions siempre prepara el checkout candidato antes de la ejecución de la VM. Su almacén de pnpm se cachea por sistema operativo, versión de Node y lockfile. La ejecución de código fuente en la VM también usa `/var/cache/crabbox/pnpm` cuando está presente. ## Interpretación de tiempos `mantis-slack-desktop-smoke-report.md` incluye tiempos por fase: - `crabbox.warmup`: arranque del proveedor de nube, disponibilidad de escritorio/navegador y SSH. - `crabbox.inspect`: búsqueda de metadatos del lease. - `credentials.prepare`: adquisición del lease de credenciales de Convex. - `crabbox.remote_run`: sincronización, inicio del navegador, instalación/compilación de OpenClaw o validación de hidratación, inicio del Gateway, captura de pantalla y captura de video. - `artifacts.copy`: rsync de vuelta desde la VM. `crabbox.remote_run` puede marcarse como `accepted` cuando Crabbox devuelve un estado remoto distinto de cero después de que Mantis haya copiado metadatos que prueban que el Gateway de OpenClaw está activo y que la configuración se completó. Trata `accepted` como aprobado con explicación, no como un escenario fallido. Si la ejecución es lenta: - predomina warmup: prebakea o promueve una mejor imagen de proveedor de Crabbox; - predomina remote_run en `source`: usa un lease caliente, mejora la reutilización del almacén de pnpm o mueve los prerrequisitos de máquina a la imagen del proveedor; - predomina remote_run en `prehydrated`: el workspace remoto en realidad no estaba listo, o la configuración del Gateway/navegador/Slack es lenta; - predomina la copia de artefactos: inspecciona el tamaño del video y el contenido del directorio de artefactos. ## Lista de verificación de evidencia Un buen comentario de PR debería mostrar: - id de escenario y SHA candidato; - URL de ejecución de GitHub Actions; - URL del artefacto; - captura de pantalla inline; - vista previa animada inline cuando esté disponible; - enlaces al MP4 completo y al MP4 recortado; - estado aprobado/fallido; - resumen de tiempos en el reporte adjunto. No confirmes capturas de pantalla ni videos en el repositorio. Mantenlos en artefactos de GitHub Actions o en el comentario del PR. ## Manejo de fallos Si el workflow falla antes de la ejecución de la VM, inspecciona primero el job de Actions. Las causas típicas son un `candidate_ref` no confiable, secretos de entorno faltantes o fallo de instalación/compilación del candidato. Si la ejecución de la VM falla pero las capturas de pantalla se copiaron de vuelta, inspecciona: ```bash 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 ``` Si la ejecución mantuvo el lease, abre VNC con el comando `crabbox vnc ...` del reporte. Detén el lease cuando termines: ```bash crabbox stop --provider aws ``` Si el inicio de sesión de Slack expiró, repáralo en VNC en un lease conservado y vuelve a ejecutar con `--lease-id`. No bakees ese perfil de navegador en una imagen de proveedor. ## Relacionado - [Resumen de QA](/es/concepts/qa-e2e-automation) - [Canal Slack](/es/channels/slack) - [Pruebas](/es/help/testing)