فرس النبي

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.

​

الأهداف

• إعادة إنتاج خطأ من issue أو PR على GitHub بشكل النقل نفسه الذي يراه المستخدمون.
• التقاط أثر قبل على مرجع الأساس قبل تطبيق الإصلاح.
• التقاط أثر بعد على المرجع المرشّح بعد تطبيق الإصلاح.
• استخدام oracle حتمي كلما أمكن، مثل قراءة تفاعل Discord عبر REST أو فحص نص قناة.
• التقاط لقطات شاشة عندما يكون للخطأ سطح UI مرئي.
• التشغيل محليًا من CLI يتحكم فيه الوكيل وعن بُعد من GitHub.
• حفظ قدر كاف من حالة الجهاز لإنقاذ VNC عندما يتعطل تسجيل الدخول، أو أتمتة المتصفح، أو مصادقة المزوّد.
• نشر حالة موجزة إلى قناة Discord للمشغّل عندما يكون التشغيل محظورًا، أو يحتاج إلى مساعدة VNC يدوية، أو ينتهي.

​

ما ليس ضمن الأهداف

• Mantis ليس بديلًا عن اختبارات الوحدة. يجب أن يتحول تشغيل Mantis عادةً إلى اختبار انحدار أصغر بعد فهم الإصلاح.
• Mantis ليس بوابة CI السريعة المعتادة. فهو أبطأ، ويستخدم بيانات اعتماد حية، ومخصص للأخطاء التي تهم فيها البيئة الحية.
• يجب ألا يتطلب Mantis وجود إنسان في التشغيل العادي. VNC اليدوي مسار إنقاذ، وليس المسار السعيد.
• لا يخزّن Mantis أسرارًا خامًا في الآثار، أو السجلات، أو لقطات الشاشة، أو تقارير Markdown، أو تعليقات PR.

​

الملكية

• تمتلك OpenClaw runtime السيناريو، ومحوّلات النقل، ومخطط الأدلة، وCLI المحلي ضمن pnpm openclaw qa mantis.
• يمتلك QA Lab أجزاء أداة النقل الحية، ومساعدات التقاط المتصفح، وكتّاب الآثار.
• يمتلك Crabbox أجهزة Linux الدافئة عندما تكون VM عن بُعد مطلوبة.
• تمتلك GitHub Actions نقطة دخول workflow عن بُعد والاحتفاظ بالآثار.
• يمتلك ClawSweeper توجيه تعليقات GitHub: تحليل أوامر المشرف، وإرسال workflow، ونشر تعليق PR النهائي.
• تقود وكلاء OpenClaw تشغيل Mantis عبر Codex عندما يحتاج السيناريو إلى إعداد وكيل، أو تصحيح أخطاء، أو الإبلاغ عن حالة عالقة.

​

شكل الأمر

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 عبر سطح مكتب Crabbox حقيقي.
• يعيد --browser-profile-dir <remote-path> استخدام Chrome user-data-dir عن بُعد حتى يستطيع سطح مكتب Mantis دائم البقاء مسجل الدخول بين التشغيلات. استخدم هذا لملف تعريف عارض Discord Web طويل العمر.
• يستعيد --browser-profile-archive-env <name> أرشيف Chrome user-data-dir بصيغة base64 .tgz من متغير البيئة المسمى قبل تشغيل المتصفح. استخدم هذا للشهود المسجّلين الدخول مثل Discord Web. متغير البيئة الافتراضي هو OPENCLAW_MANTIS_BROWSER_PROFILE_TGZ_B64.
• يتحكم --video-duration <seconds> في طول التقاط MP4. استخدم مدة أطول لتطبيقات الويب المسجّلة الدخول البطيئة التي تحتاج وقتًا للاستقرار.
• يبقي --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 إلى OPENCLAW_LIVE_OPENAI_KEY قبل استدعاء Crabbox حتى يستطيع تمرير بيئة OPENCLAW_* في Crabbox حمله إلى VM.

• يعيد --lease-id <cbx_...> التشغيل مقابل جهاز سجّل فيه مشغّل الدخول مسبقًا إلى Slack Web عبر VNC.
• يبدأ --gateway-setup Gateway دائمًا لـ OpenClaw Slack داخل VM بدلًا من تشغيل مسار QA من bot إلى bot فقط.
• يبقي --keep-lease VM الخاصة بالـ Gateway مفتوحة لفحص VNC بعد النجاح؛ ويوقفها --no-keep-lease بعد جمع الآثار.
• يفتح --slack-url <url> عنوان URL محددًا لـ Slack Web. من دونه، يشتق Mantis https://app.slack.com/client/<team>/<channel> من Slack auth.test عندما يكون رمز bot الخاص بـ SUT متاحًا.
• يتحكم --slack-channel-id <id> في allowlist قناة Slack المستخدمة بواسطة إعداد Gateway.
• يتحكم OPENCLAW_MANTIS_SLACK_BROWSER_PROFILE_DIR في ملف تعريف Chrome الدائم داخل VM. الافتراضي هو $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 فقط.
• candidate_ref: المرجع المتوقع أن يُظهر queued -> thinking -> done.

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

• --lease-id <cbx_...> يعيد التشغيل ضد VM سجّل فيها مشغل الدخول مسبقًا إلى Telegram Desktop.
• --telegram-profile-archive-env <name> يقرأ أرشيف ملف تعريف Telegram Desktop بتنسيق .tgz ومرمزًا بـ base64 من متغير env ذلك ويستعيده قبل التشغيل.
• --telegram-profile-dir <remote-path> يتحكم في دليل ملف تعريف Telegram Desktop البعيد. القيمة الافتراضية هي $HOME/.local/share/TelegramDesktop.
• --no-gateway-setup يثبت Telegram Desktop ويفتحه دون ضبط OpenClaw.
• --credential-source convex --credential-role ci يستخدم وسيط الاعتماد المشترك بدلًا من رموز env المباشرة لـ Telegram.

{
  "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: لقطة شاشة سيناريو حتمية، عادة قبل/بعد.
• desktopScreenshot: لقطة شاشة لسطح مكتب VNC/المتصفح.
• motionPreview: GIF متحرك مضمّن مولد من تسجيل سطح المكتب.
• motionClip: MP4 مقتص بالحركة يزيل البداية والنهاية الساكنتين.
• fullVideo: تسجيل MP4 كامل للفحص العميق.
• metadata: ملف JSON/سجل مرافق.
• report: تقرير Markdown.

@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. الحصول على بيانات الاعتماد.
2. تخصيص VM أو إعادة استخدامها.
3. تجهيز ملف تعريف سطح المكتب/المتصفح عندما يحتاج السيناريو إلى دليل UI.
4. تجهيز checkout نظيف لمرجع الأساس.
5. تثبيت التبعيات وبناء ما يحتاجه السيناريو فقط.
6. بدء OpenClaw Gateway فرعي بدليل حالة معزول.
7. ضبط النقل الحي والمزود والنموذج وملف تعريف المتصفح.
8. تشغيل السيناريو والتقاط دليل الأساس.
9. إيقاف Gateway والاحتفاظ بالسجلات.
10. تجهيز مرجع المرشح في VM نفسها.
11. تشغيل السيناريو نفسه والتقاط دليل المرشح.
12. مقارنة نتائج oracle والدليل البصري.
13. كتابة Markdown وJSON والسجلات ولقطات الشاشة وآثار التتبع الاختيارية.
14. رفع آثار GitHub Actions.
15. نشر رسالة حالة موجزة في PR أو Discord.

• إعادة إنتاج الخطأ: فشل الأساس بالطريقة المتوقعة.
• فشل Harness: فشل إعداد البيئة أو بيانات الاعتماد أو Discord API أو المتصفح أو المزود قبل أن تصبح oracle الخطأ ذات معنى.

​

Discord MVP

• إنه مرئي في Discord كتفاعلات على الرسالة المشغلة.
• لديه oracle REST قوية عبر حالة تفاعل رسالة Discord.
• يختبر OpenClaw Gateway حقيقيًا، ومصادقة بوت Discord، وإرسال الرسائل، ووضع تسليم الرد المصدر، وحالة تفاعل الحالة، ودورة حياة دورة النموذج.
• إنه ضيق بما يكفي لإبقاء التنفيذ الأول صادقًا.

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 يشغل بالفعل مسار Discord حيًا مع بوتات driver و SUT.
• مشغل النقل الحي يكتب بالفعل تقارير وآثار رسائل مرصودة تحت .artifacts/qa-e2e/.
• إيجارات بيانات اعتماد Convex توفر بالفعل وصولًا حصريًا إلى بيانات اعتماد النقل الحي المشتركة.
• تدعم خدمة التحكم بالمتصفح بالفعل لقطات الشاشة واللقطات وملفات التعريف المدارة headless وملفات تعريف CDP البعيدة.
• لدى QA Lab بالفعل UI مصحح أخطاء وناقل لاختبارات على شكل نقل.

​

نموذج الدليل

.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

• المراجع وSHAs المختبرة
• النقل ومعرف السيناريو
• مزود الآلة ومعرف الآلة أو معرف الإيجار
• مصدر بيانات الاعتماد دون قيم سرية
• نتيجة الأساس
• نتيجة المرشح
• ما إذا كان الخطأ قد أعيد إنتاجه على الأساس
• ما إذا كان المرشح قد أصلحه
• مسارات الآثار
• مشكلات الإعداد أو التنظيف المنقحة

​

المتصفح وVNC

• الأتمتة بلا واجهة: الافتراضي لـ CI. يعمل Chrome مع تفعيل CDP، وتلتقط Playwright أو تحكم متصفح OpenClaw لقطات الشاشة.
• إنقاذ VNC: مفعّل على VM نفسه عندما يحتاج تسجيل الدخول، أو MFA، أو منع Discord للأتمتة، أو التصحيح المرئي إلى تدخل بشري.

• معرّف التشغيل
• معرّف السيناريو
• مزوّد الجهاز
• دليل المصنوعات
• تعليمات اتصال VNC أو noVNC إذا كانت متاحة
• نصًا قصيرًا عن العائق

​

الأجهزة

• Linux مع تثبيت Chrome أو Chromium قادر على سطح المكتب
• وصول CDP لأتمتة المتصفح
• VNC أو noVNC للإنقاذ
• Node 22 وpnpm
• نسخة عمل من OpenClaw وذاكرة تخزين مؤقت للاعتماديات
• ذاكرة تخزين مؤقت لمتصفح Playwright Chromium عند استخدام Playwright
• ما يكفي من CPU والذاكرة لتشغيل OpenClaw Gateway واحد، ومتصفح واحد، وتشغيل نموذج واحد
• وصول صادر إلى 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
• OPENCLAW_QA_REDACT_PUBLIC_METADATA=1 لعمليات رفع مصنوعات GitHub العامة
• 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> |

​

ملاحظات النشر الخاص

​

إضافة سيناريو

• المعرّف والعنوان
• النقل
• بيانات الاعتماد المطلوبة
• سياسة مرجع الأساس
• سياسة مرجع المرشح
• رقعة إعدادات OpenClaw
• خطوات الإعداد
• المحفّز
• أوراكل الأساس المتوقع
• أوراكل المرشح المتوقع
• أهداف الالتقاط المرئي
• ميزانية المهلة
• خطوات التنظيف

• حالة تفاعل Discord لعلل التفاعلات
• مراجع رسائل Discord لعلل تسلسل المحادثات
• الطابع الزمني لسلاسل Slack وحالة API التفاعلات لعلل Slack
• معرّفات الرسائل والرؤوس لعلل البريد الإلكتروني
• لقطات شاشة المتصفح عندما تكون UI هي الشيء الوحيد الموثوق قابلًا للملاحظة

​

توسعة المزوّدين

• Slack: التفاعلات، والسلاسل، وإشارات التطبيق، والنوافذ، ورفع الملفات.
• البريد الإلكتروني: مصادقة Gmail وتسلسل الرسائل باستخدام gog حيث لا تكفي الموصلات.
• WhatsApp: تسجيل الدخول عبر QR، وإعادة التعريف، وتسليم الرسائل، والوسائط، والتفاعلات.
• Telegram: بوابات الإشارة في المجموعات، والأوامر، والتفاعلات حيثما تتوفر.
• Matrix: الغرف المشفرة، وعلاقات السلاسل أو الردود، واستئناف إعادة التشغيل.

​

أسئلة مفتوحة

• أي بوت Discord يجب أن يكون السائق، وأيها يجب أن يكون SUT، عند إعادة استخدام بوت Mantis الحالي؟
• هل يجب أن يستخدم تسجيل دخول متصفح المراقب حساب Discord بشريًا، أو حساب اختبار، أم أدلة REST القابلة للقراءة بواسطة البوت فقط للمرحلة الأولى؟
• إلى متى يجب أن يحتفظ GitHub بمصنوعات Mantis الخاصة بـ PRs؟
• متى يجب أن يوصي ClawSweeper تلقائيًا باستخدام Mantis بدلًا من انتظار أمر من أحد الصائنين؟
• هل يجب تنقيح لقطات الشاشة أو قصها قبل الرفع لـ PRs العامة؟