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 デスクトップ QA は、Linux デスクトップ、VNC レスキュー、Slack Web、実際の OpenClaw Gateway、スクリーンショット、動画、PR 証拠コメントを必要とする Slack クラスのバグ向けの実 UI レーンです。 ユニットテストやヘッドレス Slack ライブレーンではバグを証明できない場合に使用します。

​
ストレージモデル

Mantis は 3 つの異なるストレージ層を使用します。
  • プロバイダーイメージ: 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 コメントは非表示の <!-- 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
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 は安全側で失敗します。

​
ハイドレートモード

モード使用する場合リモート動作トレードオフ
source通常の PR 証明、コールドマシン、CIVM 内で pnpm install --frozen-lockfile --prefer-offline と pnpm build を実行します最も遅いが、最も強いソースチェックアウト証明
prehydrated再利用リースを意図的に準備した場合既存の node_modules と dist/ が必要です。インストール/ビルドをスキップします高速ですが、オペレーター管理のウォームリースに対してのみ有効です
GitHub Actions は VM 実行前に常に候補チェックアウトを準備します。その pnpm ストアは OS、Node バージョン、ロックファイルでキャッシュされます。VM ソース実行も、存在する場合は /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 戻し。
Mantis が OpenClaw Gateway が生きていてセットアップが完了したことを証明するメタデータをコピーした後に Crabbox がゼロ以外のリモートステータスを返した場合、crabbox.remote_run は accepted とマークされることがあります。accepted は失敗したシナリオではなく、説明付きの合格として扱ってください。 実行が遅い場合:
  • warmup が支配的: より良い Crabbox プロバイダーイメージを事前焼き込みするか昇格します;
  • source で remote_run が支配的: ウォームリースを使用する、pnpm ストア再利用を改善する、またはマシン前提条件をプロバイダーイメージに移動します;
  • prehydrated で remote_run が支配的: リモートワークスペースが実際には準備できていない、または Gateway/ブラウザー/Slack セットアップが遅い状態です;
  • アーティファクトコピーが支配的: 動画サイズとアーティファクトディレクトリの内容を調べます。

​
証拠チェックリスト

良い PR コメントには以下を表示する必要があります。
  • シナリオ ID と候補 SHA;
  • GitHub Actions 実行 URL;
  • アーティファクト URL;
  • インラインスクリーンショット;
  • 利用可能な場合はインラインアニメーションプレビュー;
  • 完全な 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 で再実行します。そのブラウザープロファイルをプロバイダーイメージに焼き込まないでください。

​
関連