Mantis

​

Відповідальність

• OpenClaw (extensions/qa-lab/src/mantis/*): середовище виконання сценаріїв, pnpm openclaw qa mantis <command> CLI, схема доказів.
• QA Lab (extensions/qa-lab/src/live-transports/*): середовище перевірки реального транспорту, боти драйвера/SUT, засоби запису звітів/доказів.
• 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, щоб постійний робочий стіл залишався авторизованим між запусками (використовується для довготривалого профілю переглядача Discord Web).
• --browser-profile-archive-env <name> перед запуском відновлює з цієї змінної середовища закодований у base64 архів профілю Chrome .tgz (типове значення 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 копіює його до OPENCLAW_LIVE_OPENAI_KEY перед викликом Crabbox)

​

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": "QA реакцій статусу Mantis у Discord",
  "summary": "Зрозуміле для людини верхнє зведення для коментаря до PR.",
  "scenario": "discord-status-reactions-tool-only",
  "comparison": {
    "baseline": { "sha": "...", "status": "fail", "expected": "лише в черзі" },
    "candidate": { "sha": "...", "status": "pass", "expected": "у черзі -> обмірковування -> завершено" },
    "pass": true
  },
  "artifacts": [
    {
      "kind": "timeline",
      "lane": "baseline",
      "label": "Базовий варіант: лише в черзі",
      "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 зазвичай використовують --credential-source convex і наведені нижче облікові дані брокера замість необроблених токенів бота Discord.
• 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 транспорту, браузер або постачальник дали збій до того, як перевірка результату стала змістовною.

​

Додавання сценарію

​

Відкриті питання

• Який бот Discord має бути драйвером, а який — SUT у разі повторного використання наявного бота Mantis?
• Як довго GitHub має зберігати артефакти Mantis для PR?
• Коли ClawSweeper має автоматично рекомендувати сценарій Mantis, а не чекати на команду супровідника?
• Чи потрібно редагувати або обрізати знімки екрана перед завантаженням до загальнодоступних PR?