SlackMantis Slack 桌面版手册

Mantis Slack 桌面版 QA 是针对需要 Linux 桌面、VNC 救援、Slack Web、真实的 OpenClaw 网关、屏幕截图、视频和 PR 证据评论的 Slack 级别 Bug 的真实 UI 通道。

当单元测试或无头 Slack 实时通道无法证明该 Bug 时，请使用它。

存储模型

Mantis 使用三个不同的存储层：

• 提供商映像：由 Crabbox 拥有并存储在云提供商账户中。它包含机器功能，例如 Chrome/Chromium、ffmpeg、scrot、Node/corepack/pnpm、原生构建工具和空缓存目录。
• 热租约状态：由当前操作员会话拥有。在租约存活期间，它可以包含 已登录的浏览器配置文件、/var/cache/crabbox/pnpm 和准备好的源 检出。
• Mantis 工件：由 OpenClaw 运行拥有。它们位于 OpenClaw.artifacts/qa-e2e/mantis/...GitHubGitHub 下，然后 GitHub Actions 会上传它们，且 Mantis GitHub App 会在 PR 上评论内联证据。

切勿将机密信息、浏览器 Cookie、Slack 登录状态、存储库检出、 Slacknode_modules 或 dist/ 放入预构建的提供商镜像中。

GitHub 分发

从 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

允许的 candidate_ref 值被有意限制得很窄，因为该工作流 使用实时凭证：当前的 main 祖先、发布标签或来自 openclaw/openclaw 的开放 PR 头部。

该工作流会写入：

• 上传的工件：mantis-slack-desktop-smoke-<run-id>-<attempt>；
• 来自 Mantis GitHub App 的内联 PR 评论；
• 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；
• 远程日志，例如 slack-desktop-command.log、openclaw-gateway.log、 chrome.log 和 ffmpeg.log。

PR 评论会通过隐藏的 <!-- mantis-slack-desktop-smoke --> 标记就地更新。

本地 CLI

冷源证明：

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

保留 VM 以进行 VNC 救援：

pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --class standard \
  --gateway-setup \
  --scenario slack-canary \
  --keep-lease

打开 VNC：

crabbox vnc --provider aws --id <cbx_id> --open

复用热租约：

pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --lease-id <cbx_id-or-slug> \
  --gateway-setup \
  --scenario slack-canary \
  --hydrate-mode source

仅当复用的远程工作空间已经 拥有 node_modules 和已构建的 dist/ 时，才使用 --hydrate-mode prehydrated。如果缺少这些，Mantis 将以失败封闭。

验证原生 Slack 批准 UI：

pnpm openclaw qa mantis slack-desktop-smoke \
  --provider aws \
  --class standard \
  --approval-checkpoints \
  --credential-source convex \
  --credential-role maintainer \
  --hydrate-mode source

批准检查点模式与 --gateway-setup 互斥。除非您传递显式的批准检查点 --scenario 标志，否则它将运行选入的 slack-approval-exec-native 和 slack-approval-plugin-native 场景；其他 Slack 场景在 VM 启动前被拒绝。Slack QA 运行程序根据它观察到的真实 Slack API 消息写入每个检查点 JSON 文件，然后远程监视器将该消息快照渲染为 approval-checkpoints/<scenario>-pending.png 和 approval-checkpoints/<scenario>-resolved.png。如果任何检查点 JSON、消息证据、ack JSON 或渲染的屏幕截图缺失或为空，则运行失败。

冷 GitHub Actions 租赁没有 Slack Web Cookie，因此它们的浏览器捕获可能会停留在 Slack 登录页面。对于批准检查点证明，请信任渲染的检查点图像和 Slack QA 工件，而不是 Slack slack-desktop-smoke.png。仅当浏览器屏幕截图本身必须显示 Slack Web 时，才使用保留的具有手动登录 Slack Web 配置文件的温租赁。

Hydrate 模式

模式	使用场景	远程行为	权衡
source	常规 PR 证明、冷机器、CI	在 VM 内运行 pnpm install --frozen-lockfile --prefer-offline 和 pnpm build	最慢，最强的源码检出证明
prehydrated	您有意准备了一个可重用的租赁	需要现有的 node_modules 和 dist/；跳过安装/构建	快速，但仅对操作员控制的温租赁有效

GitHub Actions 始终在 VM 运行之前准备候选检出。其 pnpm 存储按操作系统、Node 版本和锁定文件进行缓存。VM 源码运行也会在存在时使用 /var/cache/crabbox/pnpm。

计时解读

mantis-slack-desktop-smoke-report.md 包括阶段计时：

• crabbox.warmup：云提供商引导、桌面/浏览器就绪状态和 SSH。
• crabbox.inspect：租赁元数据查找。
• credentials.prepare：Convex 凭证租约获取。
• crabbox.remote_runOpenClaw：同步、浏览器启动、OpenClaw 安装/构建或 水合验证、网关启动、截图和视频捕获。
• artifacts.copy：从 VM rsync 回传。

当 Crabbox 返回非零远程状态，且 Mantis 已复制元数据证明 OpenClaw 网关设置已完成或 Slack QA 命令本身已成功退出时，crabbox.remote_run 可被标记为 acceptedOpenClawSlack。 将 accepted 视为带有说明的通过，而非失败场景。

如果运行缓慢：

• warmup 占主导：预烘焙或升级更好的 Crabbox 提供商镜像；
• remote_run 在 source 中占主导：使用温租约，改进 pnpm 存储库复用， 或将机器先决条件移入提供商镜像；
• remote_run 在 prehydratedSlack 中占主导：远程工作空间实际上未就绪， 或网关/浏览器/Slack 设置较慢；
• artifact copy 占主导：检查视频大小和构件目录内容。

证据清单

一个良好的 PR 评论应显示：

• 场景 ID 和候选 SHA；
• GitHub Actions 运行 URL；
• 构件 URL；
• 内联批准检查点截图，或来自已登录温租约的 Slack Web 截图；
• 可用时的内联动画预览；
• 完整 MP4 和裁剪后的 MP4 链接；
• 通过/失败状态；
• 附件报告中的时序摘要。

不要将截图或视频提交到仓库中。请将其保留在 GitHub Actions 构件或 PR 评论中。

失败处理

如果工作流在 VM 运行之前失败，请首先检查 Actions 作业。典型 原因是不受信任的 candidate_ref、缺少环境密钥或候选 安装/构建失败。

如果 VM 运行失败但截图已回传，请检查：

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

如果运行保留了租约，请使用报告中的 crabbox vnc ... 命令打开 VNC。 完成后停止租约：

crabbox stop --provider aws <cbx_id-or-slug>

如果 Slack 登录过期，请在保留的租约上的 VNC 中修复它，并使用 Slack--lease-id 重新运行。不要将该浏览器配置文件烘焙到提供商映像中。

相关

• QA 概述
• Slack 渠道
• 测试