نظرة عامة على ضمان الجودة

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.

• extensions/qa-channel: قناة رسائل اصطناعية ذات أسطح للرسائل المباشرة، والقنوات، والسلاسل، والتفاعلات، والتعديل، والحذف.
• extensions/qa-lab: واجهة مصحّح أخطاء وناقل QA لمراقبة النص المنقول، وحقن الرسائل الواردة، وتصدير تقرير Markdown.
• extensions/qa-matrix، وPlugins التشغيل المستقبلية: محوّلات نقل حيّة تشغّل قناة حقيقية داخل Gateway QA فرعية.
• qa/: أصول أولية مدعومة بالمستودع لمهمة البدء وسيناريوهات QA الأساسية.
• Mantis: تحقق حي قبل وبعد للأخطاء التي تحتاج إلى وسائل نقل حقيقية، ولقطات شاشة للمتصفح، وحالة VM، وأدلة PR.

​

سطح الأوامر

​

تدفق المشغّل

• اليسار: لوحة معلومات Gateway (واجهة التحكم) مع الوكيل.
• اليمين: QA Lab، يعرض النص المنقول الشبيه بـ Slack وخطة السيناريو.

pnpm qa:lab:up

pnpm openclaw qa docker-build-image
pnpm qa:lab:build
pnpm qa:lab:up:fast
pnpm qa:lab:watch

pnpm qa:otel:smoke

pnpm openclaw qa matrix --profile fast --fail-fast

pnpm openclaw qa telegram
pnpm openclaw qa discord
pnpm openclaw qa slack

pnpm openclaw qa mantis slack-desktop-smoke \
  --gateway-setup \
  --scenario slack-canary \
  --keep-lease

pnpm openclaw qa mantis visual-task \
  --browser-url https://example.net \
  --expect-text "Example Domain" \
  --vision-model openai/gpt-5.4

pnpm openclaw qa credentials doctor

​

تغطية النقل الحي

pnpm openclaw qa suite --runner multipass --scenario channel-chat-baseline

​

مرجع Telegram وDiscord وSlack QA

​

أعلام CLI المشتركة

​

Telegram QA

pnpm openclaw qa telegram

• OPENCLAW_QA_TELEGRAM_GROUP_ID - معرف محادثة رقمي (سلسلة).
• OPENCLAW_QA_TELEGRAM_DRIVER_BOT_TOKEN
• OPENCLAW_QA_TELEGRAM_SUT_BOT_TOKEN

• OPENCLAW_QA_TELEGRAM_CAPTURE_CONTENT=1 يحتفظ بمحتوى الرسائل في عناصر الرسائل المرصودة (الافتراضي يحجبها).

• telegram-canary
• telegram-mention-gating
• telegram-mentioned-message-reply
• telegram-help-command
• telegram-commands-command
• telegram-tools-compact-command
• telegram-whoami-command
• telegram-status-command
• telegram-repeated-command-authorization
• telegram-other-bot-command-gating
• telegram-context-command
• telegram-current-session-status-tool
• telegram-reply-chain-exact-marker
• telegram-stream-final-single-message
• telegram-long-final-reuses-preview
• telegram-long-final-three-chunks

• telegram-qa-report.md
• telegram-qa-summary.json - يتضمن RTT لكل رد (إرسال المشغل → ملاحظة رد SUT) بدءًا من Canary.
• telegram-qa-observed-messages.json - تُحجب المحتويات ما لم يكن OPENCLAW_QA_TELEGRAM_CAPTURE_CONTENT=1.

​

Discord QA

pnpm openclaw qa discord

• OPENCLAW_QA_DISCORD_GUILD_ID
• OPENCLAW_QA_DISCORD_CHANNEL_ID
• OPENCLAW_QA_DISCORD_DRIVER_BOT_TOKEN
• OPENCLAW_QA_DISCORD_SUT_BOT_TOKEN
• OPENCLAW_QA_DISCORD_SUT_APPLICATION_ID - يجب أن يطابق معرّف مستخدم بوت SUT الذي يعيده Discord (وإلا يفشل المسار بسرعة).

• يحافظ OPENCLAW_QA_DISCORD_CAPTURE_CONTENT=1 على نصوص الرسائل في عتاد الرسائل المرصودة.
• يحدد OPENCLAW_QA_DISCORD_VOICE_CHANNEL_ID قناة الصوت/المنصة لـ discord-voice-autojoin؛ وبدونه، يختار السيناريو أول قناة صوت/منصة مرئية لبوت SUT.

• discord-canary
• discord-mention-gating
• discord-native-help-command-registration
• discord-voice-autojoin - سيناريو صوت اختياري. يعمل بمفرده، ويفعّل channels.discord.voice.autoJoin، ويتحقق من أن حالة صوت Discord الحالية لبوت SUT هي قناة الصوت/المنصة الهدف. قد تتضمن بيانات اعتماد Discord في Convex قيمة voiceChannelId اختيارية؛ وإلا يكتشف المشغّل أول قناة صوت/منصة مرئية في الخادم.
• discord-status-reactions-tool-only - سيناريو Mantis اختياري. يعمل بمفرده لأنه يبدّل SUT إلى ردود خادم دائمة التشغيل ومقتصرة على الأدوات مع messages.statusReactions.enabled=true، ثم يلتقط مخططًا زمنيًا لتفاعلات REST إضافة إلى عتاد مرئي HTML/PNG. كما تحافظ تقارير Mantis قبل/بعد على عتاد MP4 المقدّم من السيناريو باسمَي baseline.mp4 وcandidate.mp4.

pnpm openclaw qa discord \
  --scenario discord-voice-autojoin \
  --provider-mode mock-openai

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

• discord-qa-report.md
• discord-qa-summary.json
• discord-qa-observed-messages.json - تُنقّح النصوص ما لم يكن OPENCLAW_QA_DISCORD_CAPTURE_CONTENT=1.
• discord-qa-reaction-timelines.json وdiscord-status-reactions-tool-only-timeline.png عند تشغيل سيناريو تفاعل الحالة.

​

ضمان جودة Slack

pnpm openclaw qa slack

• OPENCLAW_QA_SLACK_CHANNEL_ID
• OPENCLAW_QA_SLACK_DRIVER_BOT_TOKEN
• OPENCLAW_QA_SLACK_SUT_BOT_TOKEN
• OPENCLAW_QA_SLACK_SUT_APP_TOKEN

• يحافظ OPENCLAW_QA_SLACK_CAPTURE_CONTENT=1 على نصوص الرسائل في عتاد الرسائل المرصودة.

• slack-canary
• slack-mention-gating
• slack-allowlist-block
• slack-top-level-reply-shape
• slack-restart-resume
• slack-thread-follow-up
• slack-thread-isolation

• slack-qa-report.md
• slack-qa-summary.json
• slack-qa-observed-messages.json - تُنقّح النصوص ما لم يكن OPENCLAW_QA_SLACK_CAPTURE_CONTENT=1.

​

إعداد مساحة عمل Slack

• channelId - معرّف Cxxxxxxxxxx لقناة دُعي إليها كلا البوتين. استخدم قناة مخصصة؛ ينشر المسار في كل تشغيل.
• driverBotToken - رمز البوت (xoxb-...) لتطبيق المشغّل.
• sutBotToken - رمز البوت (xoxb-...) لتطبيق SUT، ويجب أن يكون تطبيق Slack منفصلًا عن المشغّل حتى يكون معرّف مستخدم البوت متميزًا.
• sutAppToken - رمز على مستوى التطبيق (xapp-...) لتطبيق SUT مع connections:write، ويستخدمه Socket Mode حتى يستطيع تطبيق SUT تلقي الأحداث.

{
  "display_information": {
    "name": "OpenClaw QA Driver",
    "description": "Test driver bot for OpenClaw QA Slack live lane"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw QA Driver",
      "always_online": true
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": ["chat:write", "channels:history", "groups:history", "users:read"]
    }
  },
  "settings": {
    "socket_mode_enabled": false
  }
}

{
  "display_information": {
    "name": "OpenClaw QA SUT",
    "description": "OpenClaw QA SUT connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw QA SUT",
      "always_online": true
    },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed"
      ]
    }
  }
}

• التثبيت في مساحة العمل ← انسخ رمز OAuth لمستخدم البوت ← يصبح ذلك sutBotToken.
• المعلومات الأساسية ← رموز على مستوى التطبيق ← إنشاء رمز ونطاقات ← أضف النطاق connections:write ← احفظ ← انسخ قيمة xapp-... ← تصبح ذلك sutAppToken.

/invite @OpenClaw QA Driver
/invite @OpenClaw QA SUT

{
  "channelId": "Cxxxxxxxxxx",
  "driverBotToken": "xoxb-...",
  "sutBotToken": "xoxb-...",
  "sutAppToken": "xapp-..."
}

pnpm openclaw qa credentials add \
  --kind slack \
  --payload-file slack-creds.json \
  --note "QA Slack pool seed"

pnpm openclaw qa credentials list --kind slack --status all --json

pnpm openclaw qa slack \
  --credential-source convex \
  --credential-role maintainer \
  --output-dir .artifacts/qa-e2e/slack-local

​

مجمع بيانات اعتماد Convex

• Telegram (kind: "telegram"): { groupId: string, driverToken: string, sutToken: string } - يجب أن يكون groupId سلسلة معرّف دردشة رقمية.
• مستخدم Telegram حقيقي (kind: "telegram-user"): { groupId: string, sutToken: string, testerUserId: string, testerUsername: string, telegramApiId: string, telegramApiHash: string, tdlibDatabaseEncryptionKey: string, tdlibArchiveBase64: string, tdlibArchiveSha256: string, desktopTdataArchiveBase64: string, desktopTdataArchiveSha256: string } - استئجار حصري واحد لحساب مؤقت يستخدمه كل من مشغّل TDLib CLI وشاهد Telegram Desktop المرئي.
• Discord (kind: "discord"): { guildId: string, channelId: string, driverBotToken: string, sutBotToken: string, sutApplicationId: string }.
• WhatsApp (kind: "whatsapp"): { driverPhoneE164: string, sutPhoneE164: string, driverAuthArchiveBase64: string, sutAuthArchiveBase64: string, groupJid?: string } - يجب أن تكون أرقام الهاتف سلاسل E.164 متميزة.

pnpm qa:telegram-user:crabbox -- start --tdlib-url http://artifacts.openclaw.ai/tdlib-v1.8.0-linux-x64.tgz --output-dir .artifacts/qa-e2e/telegram-user-crabbox/pr-review
pnpm qa:telegram-user:crabbox -- send --session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json --text /status
pnpm qa:telegram-user:crabbox -- finish --session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json

​

بذور مدعومة بالمستودع

• qa/scenarios/index.md
• qa/scenarios/<theme>/*.md

• بيانات تعريف السيناريو
• بيانات تعريف اختيارية للفئة، والقدرة، والمسار، والمخاطر
• مراجع الوثائق والكود
• متطلبات Plugin اختيارية
• رقعة إعداد Gateway اختيارية
• qa-flow القابل للتنفيذ

• دردشة الرسائل المباشرة والقنوات
• سلوك السلاسل
• دورة حياة إجراء الرسالة
• استدعاءات cron
• استرجاع الذاكرة
• تبديل النموذج
• تسليم الوكيل الفرعي
• قراءة المستودع وقراءة الوثائق
• مهمة بناء صغيرة واحدة مثل Lobster Invaders

​

مسارات محاكاة المزوّد

• mock-openai هو محاكي OpenClaw الواعي بالسيناريو. يبقى مسار المحاكاة الحتمي الافتراضي لـ QA المدعوم بالمستودع وبوابات التكافؤ.
• aimock يبدأ خادم مزوّد مدعومًا بـ AIMock لتغطية البروتوكول التجريبي، والتجهيزات، والتسجيل/إعادة التشغيل، والفوضى. إنه إضافي ولا يستبدل موزّع سيناريوهات mock-openai.

​

محولات النقل

• يمتلك qa-lab تنفيذ السيناريو العام، وتزامن العمال، وكتابة الآثار، والتقارير.
• يمتلك محول النقل إعداد Gateway، والجاهزية، وملاحظة الوارد والصادر، وإجراءات النقل، وحالة النقل المطبعة.
• تعرّف ملفات سيناريو markdown ضمن qa/scenarios/ تشغيل الاختبار؛ يوفر qa-lab سطح وقت التشغيل القابل لإعادة الاستخدام الذي ينفذها.

​

إضافة قناة

1. محول نقل للقناة.
2. حزمة سيناريوهات تختبر عقد القناة.

• جذر الأمر openclaw qa
• بدء المجموعة وإنهاؤها
• تزامن العمال
• كتابة الآثار
• إنشاء التقرير
• تنفيذ السيناريو
• أسماء توافق بديلة لسيناريوهات qa-channel الأقدم

• كيفية تركيب openclaw qa <runner> تحت جذر qa المشترك
• كيفية إعداد Gateway لذلك النقل
• كيفية فحص الجاهزية
• كيفية حقن الأحداث الواردة
• كيفية ملاحظة الرسائل الصادرة
• كيفية عرض النصوص وحالة النقل المطبعة
• كيفية تنفيذ الإجراءات المدعومة بالنقل
• كيفية التعامل مع إعادة الضبط أو التنظيف الخاصين بالنقل

1. أبقِ qa-lab مالكًا لجذر qa المشترك.
2. نفّذ مشغل النقل على وصلة مضيف qa-lab المشتركة.
3. أبقِ الآليات الخاصة بالنقل داخل Plugin المشغل أو عدة القناة.
4. ركّب المشغل باسم openclaw qa <runner> بدلًا من تسجيل أمر جذري منافس. يجب أن تعلن Plugins المشغلة عن qaRunners في openclaw.plugin.json وأن تصدر مصفوفة qaRunnerCliRegistrations مطابقة من runtime-api.ts. أبقِ runtime-api.ts خفيفًا؛ يجب أن يبقى تنفيذ CLI الكسول والمشغل خلف نقاط دخول منفصلة.
5. ألّف أو كيّف سيناريوهات markdown ضمن أدلة qa/scenarios/ ذات السمات.
6. استخدم مساعدات السيناريو العامة للسيناريوهات الجديدة.
7. أبقِ أسماء التوافق البديلة الحالية عاملة ما لم يكن المستودع يجري ترحيلًا مقصودًا.

• إذا كان يمكن التعبير عن السلوك مرة واحدة في qa-lab، فضعه في qa-lab.
• إذا كان السلوك يعتمد على نقل قناة واحد، فأبقِه في Plugin المشغل أو عدة Plugin تلك.
• إذا احتاج سيناريو إلى قدرة جديدة يمكن لأكثر من قناة استخدامها، فأضف مساعدًا عامًا بدلًا من فرع خاص بالقناة في suite.ts.
• إذا كان السلوك ذا معنى لنقل واحد فقط، فأبقِ السيناريو خاصًا بالنقل واجعل ذلك صريحًا في عقد السيناريو.

​

أسماء مساعدات السيناريو

• waitForTransportReady
• waitForChannelReady
• injectInboundMessage
• injectOutboundMessage
• waitForTransportOutboundMessage
• waitForChannelOutboundMessage
• waitForNoTransportOutbound
• getTransportSnapshot
• readTransportMessage
• readTransportTranscript
• formatTransportTranscript
• resetTransport

​

التقارير

• ما الذي نجح
• ما الذي فشل
• ما الذي بقي محظورًا
• ما سيناريوهات المتابعة التي تستحق الإضافة

pnpm openclaw qa character-eval \
  --model openai/gpt-5.5,thinking=medium,fast \
  --model openai/gpt-5.2,thinking=xhigh \
  --model openai/gpt-5,thinking=xhigh \
  --model anthropic/claude-opus-4-6,thinking=high \
  --model anthropic/claude-sonnet-4-6,thinking=high \
  --model zai/glm-5.1,thinking=high \
  --model moonshot/kimi-k2.5,thinking=high \
  --model google/gemini-3.1-pro-preview,thinking=high \
  --judge-model openai/gpt-5.5,thinking=xhigh,fast \
  --judge-model anthropic/claude-opus-4-6,thinking=high \
  --blind-judge-models \
  --concurrency 16 \
  --judge-concurrency 16

​

وثائق ذات صلة

• Matrix QA
• قناة QA
• الاختبار
• لوحة التحكم