Mantis Slack desktop runbook

기준일: 2026-07-26
공식 기준: Mantis Slack desktop runbook

Mantis Slack desktop runbook 문서는 OpenClaw 공식 문서(concepts/mantis-slack-desktop-runbook)를 한국어로 정리한 가이드입니다. Operator runbook for Mantis Slack desktop QA: GitHub dispatch, local CLI, warm VNC leases, hydrate modes, timing interpretation, artifacts, and failure handling. 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Operator runbook for Mantis Slack desktop QA: GitHub dispatch, local CLI, warm VNC leases, hydrate modes, timing interpretation, artifacts, and failure handling.

한국어 가이드 범위: concepts/mantis-slack-desktop-runbook 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Storage model
• GitHub dispatch
• Local CLI
• Hydrate modes
• Timing interpretation
• Evidence checklist
• Failure handling
• 관련 문서

상세 내용

본문

Mantis Slack desktop QA is the real-UI lane for Slack-class bugs that need a Linux desktop, VNC rescue, Slack Web, a real OpenClaw gateway, screenshots, videos, and a PR evidence comment. Use it when unit tests or the headless Slack live lane cannot prove the bug.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Storage model

Holds machine capabilities (Chrome/Chromium, ffmpeg, scrot, Node/corepack/pnpm, native build tools) and empty cache directories.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Provider image - owned by Crabbox, stored in the cloud provider account.
• Warm lease state - owned by the current operator session. Can hold a
• Mantis artifacts - owned by the OpenClaw run. Live under

GitHub dispatch

candidate_ref is restricted because the workflow uses live credentials: it must resolve to current main ancestry, a release tag, or an open PR head in openclaw/openclaw.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• uploaded artifact mantis-slack-desktop-smoke-<run-id>-<attempt>
• inline PR comment from the 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
• remote logs: slack-desktop-command.log, openclaw-gateway.log, chrome.log, ffmpeg.log

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

Local CLI

Use --hydrate-mode prehydrated only when the reused remote workspace already has node_modules and a built dist/; Mantis fails closed otherwise.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

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

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

Hydrate modes

GitHub Actions always prepares the candidate checkout before the VM run. Its pnpm store is cached by OS, Node version, and lockfile. The VM source run also reuses /var/cache/crabbox/pnpm when present.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Mode	Use when	Remote behavior	Tradeoff
source	Normal PR proof, cold machines, CI	Runs pnpm install --frozen-lockfile --prefer-offline and pnpm build inside the VM	Slowest, strongest source-checkout proof
prehydrated	You intentionally prepared a reused lease	Requires existing node_modules and dist/; skips install/build	Fast, but only valid for operator-controlled warm leases

Timing interpretation

mantis-slack-desktop-smoke-report.md includes phase timings:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• crabbox.warmup - cloud provider boot, desktop/browser readiness, SSH.
• crabbox.inspect - lease metadata lookup.
• credentials.prepare - Convex credential lease acquisition.
• crabbox.remote_run - sync, browser launch, OpenClaw install/build or
• artifacts.copy - rsync back from the VM.
• Warmup dominates: prebake or promote a better Crabbox provider image.
• remote_run dominates in source: use a warm lease, improve pnpm store
• remote_run dominates in prehydrated: the remote workspace was not
• Artifact copy dominates: inspect video size and artifact directory contents.

Evidence checklist

Do not commit screenshots or videos into the repository. Keep them in GitHub Actions artifacts or the PR comment.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• scenario id and candidate SHA
• GitHub Actions run URL and artifact URL
• inline approval-checkpoint screenshot, or a Slack Web screenshot from a
• inline animated preview when available
• full MP4 and trimmed MP4 links
• pass/fail status and the report's timing summary

Failure handling

If the workflow fails before the VM run, inspect the Actions job first. Typical causes: untrusted candidate_ref, missing environment secrets, or a candidate install/build failure.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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 stop --provider aws <cbx_id-or-slug>

관련 문서

주요 항목:

• QA overview
• Slack channel
• Testing

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/concepts/mantis-slack-desktop-runbook
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

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

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

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

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

관련 링크

• 공식 원문: concepts/mantis-slack-desktop-runbook
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.