Mantis

​

所有範囲

• OpenClaw（extensions/qa-lab/src/mantis/*）：シナリオランタイム、pnpm openclaw qa mantis <command> CLI、エビデンススキーマ。
• QA Lab（extensions/qa-lab/src/live-transports/*）：ライブトランスポートハーネス、ドライバー/SUT bot、レポート/エビデンスライター。
• Crabbox（openclaw/crabbox）：ウォームアップ済みの Linux マシン、リース、VNC、crabbox media preview。
• GitHub Actions（.github/workflows/mantis-*.yml）：リモートエントリポイント、アーティファクト保持。
• ClawSweeper：メンテナーの PR コマンドを解析し、ワークフローをディスパッチして、最終的な PR コメントを投稿します。

​

CLI コマンド

​

discord-smoke

pnpm openclaw qa mantis discord-smoke \
  --output-dir .artifacts/qa-e2e/mantis/discord-smoke

​

run

pnpm openclaw qa mantis run \
  --transport discord \
  --scenario discord-status-reactions-tool-only \
  --baseline origin/main \
  --candidate HEAD \
  --output-dir .artifacts/qa-e2e/mantis/local-discord-status-reactions

​

desktop-browser-smoke

pnpm openclaw qa mantis desktop-browser-smoke \
  --output-dir .artifacts/qa-e2e/mantis/desktop-browser

• --lease-id <cbx_...> は、新規作成せずにウォームアップ済みのデスクトップを再利用します。
• --browser-profile-dir <remote-path> は、リモートの Chrome user-data-dir を再利用し、永続デスクトップが実行間でログイン状態を維持できるようにします（長期間使用する Discord Web ビューアープロファイルに使用）。
• --browser-profile-archive-env <name> は、起動前にその環境変数から base64 の .tgz Chrome プロファイルアーカイブを復元します（デフォルト OPENCLAW_MANTIS_BROWSER_PROFILE_TGZ_B64）。Discord Web のようなログイン済み確認環境に使用します。
• --video-duration <seconds> は MP4 のキャプチャ時間を制御します（デフォルト 10 秒）。
• --keep-lease（または OPENCLAW_MANTIS_KEEP_VM=1）は、この実行で作成したリースを VNC 検査用に開いたままにします。リースを作成した実行が失敗した場合も、デフォルトでリースを保持します。

​

slack-desktop-smoke

pnpm openclaw qa mantis slack-desktop-smoke \
  --output-dir .artifacts/qa-e2e/mantis/slack-desktop \
  --gateway-setup \
  --scenario slack-canary \
  --keep-lease

• OPENCLAW_QA_SLACK_CHANNEL_ID
• OPENCLAW_QA_SLACK_DRIVER_BOT_TOKEN
• OPENCLAW_QA_SLACK_SUT_BOT_TOKEN
• OPENCLAW_QA_SLACK_SUT_APP_TOKEN
• OPENCLAW_LIVE_OPENAI_KEY はリモートモデルレーン用です（ローカルで OPENAI_API_KEY のみが設定されている場合、Mantis は Crabbox を 呼び出す前にそれを OPENCLAW_LIVE_OPENAI_KEY へコピーします）

​

telegram-desktop-builder

pnpm openclaw qa mantis telegram-desktop-builder \
  --credential-source convex \
  --credential-role maintainer \
  --keep-lease

​

エビデンスマニフェスト

{
  "schemaVersion": 1,
  "id": "discord-status-reactions",
  "title": "Mantis Discord ステータスリアクション QA",
  "summary": "PR コメント用の人間が読める冒頭サマリー。",
  "scenario": "discord-status-reactions-tool-only",
  "comparison": {
    "baseline": { "sha": "...", "status": "fail", "expected": "queued-only" },
    "candidate": { "sha": "...", "status": "pass", "expected": "queued -> thinking -> done" },
    "pass": true
  },
  "artifacts": [
    {
      "kind": "timeline",
      "lane": "baseline",
      "label": "ベースラインは queued-only",
      "path": "baseline/timeline.png",
      "targetPath": "baseline.png",
      "alt": "ベースラインの Discord タイムライン",
      "width": 420
    }
  ]
}

.artifacts/qa-e2e/mantis/<run-id>/
  mantis-report.md
  mantis-evidence.json
  baseline/
  candidate/
  comparison.json

​

GitHub 自動化

• MANTIS_ARTIFACT_R2_ACCESS_KEY_ID
• MANTIS_ARTIFACT_R2_SECRET_ACCESS_KEY
• MANTIS_ARTIFACT_R2_BUCKET（ワークフローは openclaw-crabbox-artifacts を設定）
• MANTIS_ARTIFACT_R2_ENDPOINT
• MANTIS_ARTIFACT_R2_REGION（ワークフローは auto を設定）
• MANTIS_ARTIFACT_R2_PUBLIC_BASE_URL（ワークフローは https://artifacts.openclaw.ai を設定）

@openclaw-mantis discord status reactions
@openclaw-mantis discord status reactions baseline=origin/main candidate=HEAD
@openclaw-mantis telegram
@openclaw-mantis telegram scenario=telegram-status-command
@openclaw-mantis telegram scenarios=telegram-status-command,channel-canary
@openclaw-mantis web ui chat
@openclaw-mantis web-ui-chat candidate=HEAD

@clawsweeper mantis discord discord-status-reactions-tool-only

​

マシンとシークレット

• OPENCLAW_QA_DISCORD_MANTIS_BOT_TOKEN
• OPENCLAW_QA_DISCORD_GUILD_ID
• OPENCLAW_QA_DISCORD_CHANNEL_ID
• ローカルの qa mantis run --credential-source env には、 OPENCLAW_QA_DISCORD_DRIVER_BOT_TOKEN、OPENCLAW_QA_DISCORD_SUT_BOT_TOKEN、 OPENCLAW_QA_DISCORD_SUT_APPLICATION_ID も必要です。GitHub ワークフローでは通常、生の Discord bot トークンの代わりに --credential-source convex と以下のブローカー認証情報を使用します。
• 公開アーティファクトのアップロード用の OPENCLAW_QA_REDACT_PUBLIC_METADATA=1
• OPENCLAW_QA_CONVEX_SITE_URL、OPENCLAW_QA_CONVEX_SECRET_CI
• OPENAI_API_KEY（または Telegram Desktop 証明専用の OPENCLAW_MANTIS_AGENT_OPENAI_API_KEY）
• CRABBOX_COORDINATOR／CRABBOX_COORDINATOR_TOKEN（ワークフローでは フォールバックとして OPENCLAW_QA_MANTIS_CRABBOX_COORDINATOR／_TOKEN も受け取り、 Crabbox を呼び出す前にプレーンな名前へマッピングします）
• CRABBOX_ACCESS_CLIENT_ID、CRABBOX_ACCESS_CLIENT_SECRET
• MANTIS_GITHUB_APP_ID、MANTIS_GITHUB_APP_PRIVATE_KEY

​

実行結果

• バグを再現：ベースラインがシナリオの想定どおりに失敗しました。
• ハーネス障害：オラクルが意味を持つ前に、環境のセットアップ、認証情報、トランスポート API、ブラウザー、 またはプロバイダーが失敗しました。

​

シナリオの追加

​

未解決の課題

• 既存の Mantis ボットを再利用する場合、どの Discord ボットをドライバーとし、どのボットを SUT とすべきですか？
• GitHub は PR の Mantis アーティファクトをどのくらいの期間保持すべきですか？
• ClawSweeper は、メンテナーのコマンドを待たずに、どのような場合に Mantis シナリオを自動的に推奨すべきですか？
• 公開 PR にアップロードする前に、スクリーンショットを墨消しまたは切り抜きすべきですか？