Mantis Slack 데스크톱 운영 절차서

Mantis Slack 데스크톱 QA는 Linux 데스크톱, VNC 복구, Slack Web, 실제 OpenClaw Gateway, 스크린샷, 동영상 및 PR 증거 댓글이 필요한 Slack 계열 버그를 위한 실제 UI 경로입니다. 단위 테스트나 헤드리스 Slack 라이브 경로로 버그를 입증할 수 없을 때 사용하세요.

저장소 모델

Mantis는 세 가지 저장소 계층을 사용합니다.

제공자 이미지 - Crabbox가 소유하며 클라우드 제공자 계정에 저장됩니다. 머신 기능(Chrome/Chromium, ffmpeg, scrot, Node/corepack/pnpm, 네이티브 빌드 도구)과 비어 있는 캐시 디렉터리를 포함합니다.
웜 임대 상태 - 현재 운영자 세션이 소유합니다. 임대가 유지되는 동안 로그인된 브라우저 프로필, /var/cache/crabbox/pnpm, 준비된 소스 체크아웃을 보관할 수 있습니다.
Mantis 아티팩트 - OpenClaw 실행이 소유합니다. .artifacts/qa-e2e/mantis/... 아래에 있으며, GitHub Actions가 이를 업로드하고 Mantis GitHub App이 PR에 인라인 증거를 댓글로 게시합니다.

비밀 정보, 브라우저 쿠키, Slack 로그인 상태, 저장소 체크아웃, node_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 댓글은 숨겨진  마커를 통해 기존 위치에서 갱신됩니다.

로컬 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

VNC 복구를 위해 VM 유지:

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

--approval-checkpoints와 --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, 메시지 증거, 확인 응답 JSON 또는 렌더링된 스크린샷 중 하나라도 없거나 비어 있으면 실행이 실패합니다. 콜드 GitHub Actions 임대에는 Slack Web 쿠키가 없으므로 브라우저 캡처가 Slack 로그인 화면에 표시될 수 있습니다. 승인 체크포인트 증명에는 slack-desktop-smoke.png 대신 렌더링된 체크포인트 이미지와 Slack QA 아티팩트를 신뢰하세요. 브라우저 스크린샷 자체에 Slack Web을 표시해야 하는 경우에만 수동으로 로그인한 Slack Web 프로필이 있는 유지된 웜 임대를 사용하세요.

하이드레이션 모드

모드	사용 시점	원격 동작	절충점
`source`	일반적인 PR 증명, 콜드 머신, CI	VM 내부에서 `pnpm install --frozen-lockfile --prefer-offline` 및 `pnpm build` 실행	가장 느리지만 가장 강력한 소스 체크아웃 증명
`prehydrated`	재사용할 임대를 의도적으로 준비한 경우	기존 `node_modules` 및 `dist/`가 필요하며 설치/빌드를 건너뜀	빠르지만 운영자가 제어하는 웜 임대에서만 유효

GitHub Actions는 VM 실행 전에 항상 후보 체크아웃을 준비합니다. pnpm 저장소는 운영체제, Node 버전 및 잠금 파일을 기준으로 캐시됩니다. VM의 source 실행도 /var/cache/crabbox/pnpm이 있으면 이를 재사용합니다.

시간 해석

mantis-slack-desktop-smoke-report.md에는 단계별 소요 시간이 포함됩니다.

crabbox.warmup - 클라우드 제공자 부팅, 데스크톱/브라우저 준비 상태, SSH.
crabbox.inspect - 임대 메타데이터 조회.
credentials.prepare - Convex 자격 증명 임대 획득.
crabbox.remote_run - 동기화, 브라우저 실행, OpenClaw 설치/빌드 또는 하이드레이션 검증, Gateway 시작, 스크린샷 및 동영상 캡처.
artifacts.copy - VM에서 rsync로 다시 복사.

Crabbox가 0이 아닌 원격 상태를 반환했지만 Mantis가 OpenClaw Gateway 설정이 완료되었거나 Slack QA 명령 자체가 성공적으로 종료되었음을 입증하는 메타데이터를 복사한 경우, crabbox.remote_run에 accepted가 표시될 수 있습니다. accepted는 실패한 시나리오가 아니라 설명이 포함된 통과로 취급하세요. 실행이 느린 경우:

워밍업이 대부분을 차지함: 더 나은 Crabbox 제공자 이미지를 사전 베이크하거나 승격하세요.
source에서 remote_run이 대부분을 차지함: 웜 임대를 사용하거나, pnpm 저장소 재사용을 개선하거나, 머신 필수 구성 요소를 제공자 이미지로 이동하세요.
prehydrated에서 remote_run이 대부분을 차지함: 원격 작업 공간이 실제로 준비되지 않았거나 Gateway/브라우저/Slack 설정이 느린 것입니다.
아티팩트 복사가 대부분을 차지함: 동영상 크기와 아티팩트 디렉터리 내용을 점검하세요.

증거 체크리스트

좋은 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에서 복구하고 --lease-id를 사용하여 다시 실행하세요. 해당 브라우저 프로필을 제공자 이미지에 포함하지 마세요.

Overview

First steps

Guides

Mantis Slack 데스크톱 운영 절차서

저장소 모델

GitHub 디스패치

로컬 CLI

하이드레이션 모드

시간 해석

증거 체크리스트

실패 처리

관련 문서

​저장소 모델

​GitHub 디스패치

​로컬 CLI

​하이드레이션 모드

​시간 해석

​증거 체크리스트

​실패 처리

​관련 문서

저장소 모델

GitHub 디스패치

로컬 CLI

하이드레이션 모드

시간 해석

증거 체크리스트

실패 처리

관련 문서