カマキリ

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.

​

目標

• ユーザーが目にするものと同じトランスポート形状で、GitHub issue または PR のバグを再現する。
• 修正を適用する前に、ベースライン ref 上で before アーティファクトを取得する。
• 修正を適用した後に、候補 ref 上で after アーティファクトを取得する。
• 可能な場合は常に、Discord REST リアクションの読み取りやチャンネル transcript チェックなどの決定論的なオラクルを使用する。
• バグに可視 UI サーフェスがある場合はスクリーンショットを取得する。
• エージェント制御の CLI からローカルで、また GitHub からリモートで実行する。
• ログイン、ブラウザー自動化、またはプロバイダー認証が止まったときに VNC で救出できる十分なマシン状態を保持する。
• 実行がブロックされた場合、手動 VNC 支援が必要な場合、または完了した場合に、オペレーター用 Discord チャンネルへ簡潔なステータスを投稿する。

​

非目標

• Mantis はユニットテストの代替ではありません。Mantis 実行は通常、修正内容が理解された後で、より小さな回帰テストになるべきです。
• Mantis は通常の高速 CI ゲートではありません。低速で、ライブ認証情報を使用し、ライブ環境が重要なバグのために予約されています。
• Mantis は通常運用で人間を必要とするべきではありません。手動 VNC は救出経路であり、正常系ではありません。
• Mantis は、生のシークレットをアーティファクト、ログ、スクリーンショット、Markdown レポート、PR コメントに保存しません。

​

所有範囲

• OpenClaw は、pnpm openclaw qa mantis 配下のシナリオランタイム、トランスポートアダプター、証拠スキーマ、ローカル CLI を所有します。
• QA Lab は、ライブトランスポートハーネス部分、ブラウザー取得ヘルパー、アーティファクト書き込みを所有します。
• Crabbox は、リモート VM が必要な場合のウォーム済み Linux マシンを所有します。
• GitHub Actions は、リモートワークフローのエントリーポイントとアーティファクト保持を所有します。
• ClawSweeper は、GitHub コメントルーティングを所有します。つまり、メンテナーコマンドの解析、ワークフローのディスパッチ、最終 PR コメントの投稿です。
• OpenClaw エージェントは、シナリオにエージェント的なセットアップ、デバッグ、または停止状態レポートが必要な場合に、Codex を通じて Mantis を駆動します。

​

コマンド形状

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

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

pnpm openclaw qa mantis run \
  --transport discord \
  --scenario discord-thread-reply-filepath-attachment \
  --baseline <bug-ref> \
  --candidate <fix-ref> \
  --output-dir .artifacts/qa-e2e/mantis/local-discord-thread-attachment

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

• --lease-id <cbx_...> または OPENCLAW_MANTIS_CRABBOX_LEASE_ID は、ウォーム済みデスクトップを再利用します。
• --browser-url <url> は、可視ブラウザーで開くページを変更します。
• --html-file <path> は、リポジトリローカルの HTML アーティファクトを可視ブラウザーでレンダリングします。Mantis はこれを使用して、生成された Discord ステータスリアクション timeline を実際の Crabbox デスクトップ経由で取得します。
• --browser-profile-dir <remote-path> は、リモート Chrome user-data-dir を再利用するため、永続 Mantis デスクトップが実行間でログイン状態を維持できます。長期稼働の Discord Web ビューアープロファイルに使用します。
• --browser-profile-archive-env <name> は、ブラウザー起動前に、指定された環境変数から base64 の .tgz Chrome user-data-dir アーカイブを復元します。Discord Web など、ログイン済みの witness に使用します。デフォルトの環境変数は OPENCLAW_MANTIS_BROWSER_PROFILE_TGZ_B64 です。
• --video-duration <seconds> は MP4 取得長を制御します。安定するまで時間が必要な、低速のログイン済み Web アプリには長めの時間を使用します。
• --keep-lease または OPENCLAW_MANTIS_KEEP_VM=1 は、新しく作成され成功したリースを VNC 検査用に開いたままにします。失敗した実行では、オペレーターが再接続できるように、作成されたリースはデフォルトで保持されます。
• --class、--idle-timeout、--ttl は、マシンサイズとリース寿命を調整します。

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 にマッピングし、Crabbox の OPENCLAW_* 環境転送で VM 内へ運べるようにします。

• --lease-id <cbx_...> は、オペレーターがすでに VNC 経由で Slack Web にログインしているマシンに対して再実行します。
• --gateway-setup は、ボット間 QA レーンだけを実行する代わりに、VM 内で永続的な OpenClaw Slack Gateway を開始します。
• --keep-lease は成功後も Gateway VM を VNC 検査用に開いたままにします。--no-keep-lease はアーティファクト収集後に停止します。
• --slack-url <url> は、特定の Slack Web URL を開きます。指定しない場合、SUT ボットトークンが利用可能であれば、Mantis は Slack auth.test から https://app.slack.com/client/<team>/<channel> を導出します。
• --slack-channel-id <id> は、Gateway セットアップで使用される Slack チャンネル allowlist を制御します。
• OPENCLAW_MANTIS_SLACK_BROWSER_PROFILE_DIR は、VM 内の永続 Chrome プロファイルを制御します。デフォルトは $HOME/.config/openclaw-mantis/slack-chrome-profile であるため、手動 Slack Web ログインは同じリース上での再実行後も維持されます。
• --credential-source convex --credential-role ci は、直接の Slack 環境トークンではなく共有認証情報プールを使用します。
• --provider-mode、--model、--alt-model、--fast は、Slack ライブレーンへそのまま渡されます。

• baseline_ref: queued-only 動作を再現することが期待される ref。
• candidate_ref: queued -> thinking -> done を示すことが期待される ref。

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

• --lease-id <cbx_...> は、オペレーターがすでに Telegram Desktop にログイン済みの VM に対して再実行します。
• --telegram-profile-archive-env <name> は、その env var から base64 の .tgz Telegram Desktop profile archive を読み取り、起動前に復元します。
• --telegram-profile-dir <remote-path> は remote Telegram Desktop profile directory を制御します。デフォルトは $HOME/.local/share/TelegramDesktop です。
• --no-gateway-setup は、OpenClaw を構成せずに Telegram Desktop をインストールして開きます。
• --credential-source convex --credential-role ci は、直接の Telegram env token の代わりに shared credential broker を使用します。

{
  "schemaVersion": 1,
  "id": "discord-status-reactions",
  "title": "Mantis Discord Status Reactions QA",
  "summary": "Human-readable top summary for the PR comment.",
  "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": "Baseline queued-only",
      "path": "baseline/timeline.png",
      "targetPath": "baseline.png",
      "alt": "Baseline Discord timeline",
      "width": 420
    }
  ]
}

• timeline: deterministic scenario screenshot。通常は before/after です。
• desktopScreenshot: VNC/browser desktop screenshot。
• motionPreview: desktop recording から生成された inline animated GIF。
• motionClip: static な lead-in と tail を除去した、motion-trimmed MP4。
• fullVideo: 詳細調査用の full MP4 recording。
• metadata: JSON/log sidecar。
• report: Markdown report。

@Mantis discord status reactions

@Mantis discord status reactions baseline=origin/main candidate=HEAD

@Mantis telegram
@Mantis telegram scenario=telegram-status-command
@Mantis telegram scenarios=telegram-status-command,telegram-mentioned-message-reply

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

​

実行ライフサイクル

1. credentials を取得します。
2. VM を割り当てるか再利用します。
3. scenario が UI 証拠を必要とする場合は、desktop/browser profile を準備します。
4. baseline ref 用の clean checkout を準備します。
5. dependencies をインストールし、scenario が必要とするものだけを build します。
6. isolated state directory で child OpenClaw Gateway を開始します。
7. live transport、provider、model、browser profile を構成します。
8. scenario を実行し、baseline evidence を取得します。
9. gateway を停止し、logs を保持します。
10. 同じ VM で candidate ref を準備します。
11. 同じ scenario を実行し、candidate evidence を取得します。
12. oracle results と visual evidence を比較します。
13. Markdown、JSON、logs、screenshots、optional trace artifacts を書き込みます。
14. GitHub Actions artifacts をアップロードします。
15. 簡潔な PR または Discord status message を投稿します。

• Bug reproduced: baseline が想定どおりの失敗をしました。
• Harness failure: bug oracle が意味を持つ前に、environment setup、credentials、Discord API、browser、または provider が失敗しました。

​

Discord MVP

• triggering message 上の reactions として Discord で見えます。
• Discord message reaction state を通じた強い REST oracle があります。
• 実際の OpenClaw Gateway、Discord bot auth、message dispatch、source reply delivery mode、status reaction state、model turn lifecycle を動かします。
• 最初の実装を誠実に保つのに十分狭い範囲です。

id: discord-status-reactions-tool-only
transport: discord
baseline:
  expect:
    reproduced: true
candidate:
  expect:
    fixed: true
config:
  messages:
    ackReaction: "👀"
    ackReactionScope: "group-mentions"
    groupChat:
      visibleReplies: "message_tool"
    statusReactions:
      enabled: true
      timing:
        debounceMs: 0
discord:
  requireMention: true
  notifyChannel: operator-notify
evidence:
  rest:
    messageReactions: true
  browser:
    screenshotMessageRow: true

pnpm openclaw qa discord \
  --scenario discord-status-reactions-tool-only \
  --provider-mode live-frontier \
  --model openai/gpt-5.4 \
  --alt-model openai/gpt-5.4 \
  --fast \
  --output-dir .artifacts/qa-e2e/mantis/discord-status-reactions-candidate

​

既存の QA 要素

• pnpm openclaw qa discord は、driver と SUT bots を使用する live Discord lane をすでに実行します。
• live transport runner は、.artifacts/qa-e2e/ 配下に reports と observed-message artifacts をすでに書き込みます。
• Convex credential leases は、shared live transport credentials への exclusive access をすでに提供します。
• browser control service は、screenshots、snapshots、headless managed profiles、remote CDP profiles をすでにサポートしています。
• QA Lab には、transport-shaped testing 用の debugger UI と bus がすでにあります。

​

証拠モデル

.artifacts/qa-e2e/mantis/<run-id>/
  mantis-report.md
  mantis-summary.json
  baseline/
    summary.json
    discord-message.json
    screenshot-message-row.png
    gateway-debug/
  candidate/
    summary.json
    discord-message.json
    screenshot-message-row.png
    gateway-debug/
  comparison.json
  run.log

• テストした refs と SHAs
• transport と scenario id
• machine provider と machine id または lease id
• secret values を含まない credential source
• baseline result
• candidate result
• bug が baseline で再現したかどうか
• candidate がそれを修正したかどうか
• artifact paths
• sanitized setup または cleanup issues

​

ブラウザーと VNC

• ヘッドレス自動化: CI のデフォルトです。Chrome は CDP を有効にして実行され、 Playwright または OpenClaw のブラウザー制御がスクリーンショットを取得します。
• VNC レスキュー: ログイン、MFA、Discord の自動化対策、 または視覚的なデバッグに人の介入が必要な場合、同じ VM で有効にします。

• 実行 ID
• シナリオ ID
• マシンプロバイダー
• アーティファクトディレクトリ
• 利用可能な場合は VNC または noVNC の接続手順
• 短いブロッカー説明

​

マシン

• デスクトップ対応の Chrome または Chromium がインストールされた Linux
• ブラウザー自動化のための CDP アクセス
• レスキュー用の VNC または noVNC
• Node 22 と pnpm
• OpenClaw のチェックアウトと依存関係キャッシュ
• Playwright を使用する場合の Playwright Chromium ブラウザーキャッシュ
• 1 つの OpenClaw Gateway、1 つのブラウザー、1 回のモデル実行に十分な CPU とメモリ
• Discord、GitHub、モデルプロバイダー、認証情報ブローカーへのアウトバウンドアクセス

​

シークレット

• OPENCLAW_QA_DISCORD_MANTIS_BOT_TOKEN
• OPENCLAW_QA_DISCORD_DRIVER_BOT_TOKEN
• OPENCLAW_QA_DISCORD_SUT_BOT_TOKEN
• OPENCLAW_QA_DISCORD_GUILD_ID
• OPENCLAW_QA_DISCORD_CHANNEL_ID
• OPENCLAW_QA_DISCORD_NOTIFY_CHANNEL_ID
• 公開 GitHub アーティファクトアップロード用の OPENCLAW_QA_REDACT_PUBLIC_METADATA=1
• OPENCLAW_QA_CONVEX_SITE_URL
• OPENCLAW_QA_CONVEX_SECRET_CI
• OPENCLAW_QA_MANTIS_CRABBOX_COORDINATOR
• OPENCLAW_QA_MANTIS_CRABBOX_COORDINATOR_TOKEN

• Discord ボットトークン
• プロバイダー API キー
• ブラウザークッキー
• 認証プロファイルの内容
• VNC パスワード
• 生の認証情報ペイロード

​

GitHub アーティファクトと PR コメント

Mantis Discord Status Reactions QA

Summary: Mantis reran the reported Discord status-reaction bug against the known
bad baseline and the candidate fix. The baseline reproduced the bug, while the
candidate showed the expected queued -> thinking -> done sequence.

- Scenario: `discord-status-reactions-tool-only`
- Run: <workflow run link>
- Artifact: <artifact link>
- Baseline: `<status>` at `<sha>`
- Candidate: `<status>` at `<sha>`

| Baseline            | Candidate           |
| ------------------- | ------------------- |
| <inline screenshot> | <inline screenshot> |

​

非公開デプロイメモ

​

シナリオの追加

• ID とタイトル
• トランスポート
• 必要な認証情報
• ベースライン ref ポリシー
• 候補 ref ポリシー
• OpenClaw 設定パッチ
• セットアップ手順
• 刺激
• 期待されるベースラインオラクル
• 期待される候補オラクル
• 視覚キャプチャターゲット
• タイムアウト予算
• クリーンアップ手順

• リアクションバグには Discord リアクション状態
• スレッドバグには Discord メッセージ参照
• Slack バグには Slack スレッド ts とリアクション API 状態
• メールバグにはメールメッセージ ID とヘッダー
• UI が唯一の信頼できる観測対象である場合はブラウザースクリーンショット

​

プロバイダー拡張

• Slack: リアクション、スレッド、アプリメンション、モーダル、ファイルアップロード。
• メール: コネクターでは不十分な場合の gog を使った Gmail 認証とメッセージスレッド化。
• WhatsApp: QR ログイン、再識別、メッセージ配信、メディア、リアクション。
• Telegram: グループメンションゲーティング、コマンド、利用可能な場合はリアクション。
• Matrix: 暗号化ルーム、スレッドまたは返信関係、再起動後の再開。

​

未解決の質問

• 既存の Mantis ボットを再利用する場合、どの Discord ボットをドライバーにし、 どれを SUT にするべきか?
• 最初のフェーズでは、オブザーバーブラウザーのログインに人間の Discord アカウント、テストアカウント、 またはボットが読める REST 証拠のみのどれを使用するべきか?
• GitHub は PR 用の Mantis アーティファクトをどれくらいの期間保持するべきか?
• ClawSweeper は、メンテナーコマンドを待つ代わりに、いつ Mantis を自動的に推奨するべきか?
• 公開 PR では、アップロード前にスクリーンショットを秘匿化またはクロップするべきか?