الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Full Release Validation هو مظلة الإصدار. وهو نقطة الدخول اليدوية الوحيدة لإثبات ما قبل الإصدار، لكن معظم العمل يحدث في مسارات عمل فرعية بحيث يمكن إعادة تشغيل صندوق فاشل من دون إعادة بدء الإصدار بالكامل. شغّله من مرجع مسار عمل موثوق، عادةً main، ومرّر فرع الإصدار أو الوسم أو SHA الكامل للالتزام بوصفه ref: 
gh workflow run full-release-validation.yml \
  --ref main \
  -f ref=release/YYYY.M.D \
  -f provider=openai \
  -f mode=both \
  -f release_profile=stable
تستخدم مسارات العمل الفرعية مرجع مسار العمل الموثوق للحاضنة، وتستخدم الإدخال ref للمرشح قيد الاختبار. يضمن ذلك إتاحة منطق التحقق الجديد عند التحقق من فرع إصدار أقدم أو وسم أقدم.

​
المراحل ذات المستوى الأعلى

المرحلةالتفاصيل
حل الهدفالمهمة: Resolve target ref
مسار العمل الفرعي: لا يوجد
يثبت: يحل فرع الإصدار أو الوسم أو SHA الكامل للالتزام ويسجل الإدخالات المحددة.
إعادة التشغيل: أعد تشغيل المظلة إذا فشل هذا.
Vitest وCI العاديالمهمة: Run normal full CI
مسار العمل الفرعي: CI
يثبت: مخطط CI يدوي كامل مقابل المرجع الهدف، بما في ذلك مسارات Linux Node، وشظايا Plugin المضمّنة، وعقود القنوات، وتوافق Node 22، وcheck، وcheck-additional، وتجربة البناء، وفحوص المستندات، وPython skills، وWindows، وmacOS، وتدويل Control UI، وAndroid عبر المظلة.
إعادة التشغيل: rerun_group=ci.
ما قبل إصدار Pluginالمهمة: Run plugin prerelease validation
مسار العمل الفرعي: Plugin Prerelease
يثبت: فحوص Plugin الثابتة الخاصة بالإصدار، وتغطية Plugin الوكيلية، وشظايا الدُفعات الكاملة للامتدادات، ومسارات Docker لما قبل إصدار Plugin.
إعادة التشغيل: rerun_group=plugin-prerelease.
فحوص الإصدارالمهمة: Run release/live/Docker/QA validation
مسار العمل الفرعي: OpenClaw Release Checks
يثبت: تجربة التثبيت، وفحوص الحزم عبر أنظمة التشغيل، ومجموعات live/E2E، وأجزاء مسار إصدار Docker، وPackage Acceptance، وتكافؤ QA Lab، وMatrix المباشر، وTelegram المباشر.
إعادة التشغيل: rerun_group=release-checks أو معالج أضيق لفحوص الإصدار.
Telegram بعد النشرالمهمة: Run post-publish Telegram E2E
مسار العمل الفرعي: NPM Telegram Beta E2E
يثبت: إثبات Telegram الاختياري للحزمة المنشورة عند تعيين npm_telegram_package_spec.
إعادة التشغيل: rerun_group=npm-telegram.
محقق المظلةالمهمة: Verify full validation
مسار العمل الفرعي: لا يوجد
يثبت: يعيد فحص النتائج المسجلة لتشغيلات المسارات الفرعية ويلحق جداول أبطأ المهام من مسارات العمل الفرعية.
إعادة التشغيل: أعد تشغيل هذه المهمة فقط بعد إعادة تشغيل مسار فرعي فاشل حتى ينجح.
بالنسبة إلى ref=main وrerun_group=all، تحل مظلة أحدث محل مظلة أقدم. عند إلغاء الأصل، يلغي مراقبه أي مسار عمل فرعي كان قد أرسله بالفعل. لا تلغي تشغيلات التحقق من فروع الإصدار والوسوم بعضها بعضًا افتراضيًا.

​
مراحل فحوص الإصدار

OpenClaw Release Checks هو أكبر مسار عمل فرعي. يحل الهدف مرة واحدة ويحضّر قطعة أثرية مشتركة باسم release-package-under-test عندما تحتاجها المراحل المواجهة للحزم أو Docker.
المرحلةالتفاصيل
هدف الإصدارالمهمة: Resolve target ref
مسار العمل الداعم: لا يوجد
الاختبارات: المرجع المحدد، وSHA المتوقع الاختياري، والملف الشخصي، ومجموعة إعادة التشغيل، ومرشح مجموعة live المركّزة.
إعادة التشغيل: rerun_group=release-checks.
قطعة الحزمة الأثريةالمهمة: Prepare release package artifact
مسار العمل الداعم: لا يوجد
الاختبارات: يحزم أو يحل كرة tar مرشحة واحدة ويرفع release-package-under-test للفحوص اللاحقة المواجهة للحزم.
إعادة التشغيل: مجموعة الحزمة أو عبر أنظمة التشغيل أو live/E2E المتأثرة.
تجربة التثبيتالمهمة: Run install smoke
مسار العمل الداعم: Install Smoke
الاختبارات: مسار التثبيت الكامل مع إعادة استخدام صورة تجربة Dockerfile الجذرية، وتثبيت حزمة QR، وتجارب Docker للجذر وGateway، واختبارات Docker للمثبت، وتجربة موفر الصور لتثبيت Bun العام، وDocker E2E السريع لـPlugin المضمّنة.
إعادة التشغيل: rerun_group=install-smoke.
عبر أنظمة التشغيلالمهمة: cross_os_release_checks
مسار العمل الداعم: OpenClaw Cross-OS Release Checks (Reusable)
الاختبارات: مسارات جديدة وترقية على Linux وWindows وmacOS للموفر والوضع المحددين، باستخدام كرة tar المرشحة بالإضافة إلى حزمة أساس.
إعادة التشغيل: rerun_group=cross-os.
المستودع وlive E2Eالمهمة: Run repo/live E2E validation
مسار العمل الداعم: OpenClaw Live And E2E Checks (Reusable)
الاختبارات: E2E للمستودع، وذاكرة التخزين المؤقت المباشرة، وبث websocket من OpenAI، وشظايا الموفر المباشر الأصلي وPlugin، وحاضنات النموذج/الخلفية/Gateway المباشرة المدعومة بـDocker والمحددة بواسطة release_profile.
إعادة التشغيل: rerun_group=live-e2e، اختياريًا مع live_suite_filter.
مسار إصدار Dockerالمهمة: Run Docker release-path validation
مسار العمل الداعم: OpenClaw Live And E2E Checks (Reusable)
الاختبارات: أجزاء Docker لمسار الإصدار مقابل قطعة الحزمة الأثرية المشتركة.
إعادة التشغيل: rerun_group=live-e2e.
قبول الحزمةالمهمة: Run package acceptance
مسار العمل الداعم: Package Acceptance
الاختبارات: توافق تبعيات القنوات المضمّنة الأصلية للقطعة الأثرية، وتجهيزات حزم Plugin دون اتصال، وقبول حزمة Telegram بمحاكاة OpenAI مقابل كرة tar نفسها.
إعادة التشغيل: rerun_group=package.
تكافؤ QAالمهمة: Run QA Lab parity lane وRun QA Lab parity report
مسار العمل الداعم: مهام مباشرة
الاختبارات: حزم التكافؤ الوكيلية للمرشح والأساس، ثم تقرير التكافؤ.
إعادة التشغيل: rerun_group=qa-parity أو rerun_group=qa.
Matrix مباشر لـQAالمهمة: Run QA Lab live Matrix lane
مسار العمل الداعم: مهمة مباشرة
الاختبارات: ملف QA سريع لـMatrix المباشر في بيئة qa-live-shared.
إعادة التشغيل: rerun_group=qa-live أو rerun_group=qa.
Telegram مباشر لـQAالمهمة: Run QA Lab live Telegram lane
مسار العمل الداعم: مهمة مباشرة
الاختبارات: QA مباشر لـTelegram مع عقود إيجار بيانات اعتماد Convex CI.
إعادة التشغيل: rerun_group=qa-live أو rerun_group=qa.
محقق الإصدارالمهمة: Verify release checks
مسار العمل الداعم: لا يوجد
الاختبارات: مهام فحوص الإصدار المطلوبة لمجموعة إعادة التشغيل المحددة.
إعادة التشغيل: أعد التشغيل بعد نجاح المهام الفرعية المركّزة.

​
أجزاء مسار إصدار Docker

تشغّل مرحلة مسار إصدار Docker هذه الأجزاء عندما يكون live_suite_filter فارغًا:
الجزءالتغطية
coreمسارات تجربة مسار إصدار Docker الأساسية.
package-update-openaiسلوك تثبيت حزمة OpenAI وتحديثها.
package-update-anthropicسلوك تثبيت حزمة Anthropic وتحديثها.
package-update-coreسلوك الحزمة والتحديث المحايد للموفر.
plugins-runtime-pluginsمسارات وقت تشغيل Plugin التي تختبر سلوك Plugin.
plugins-runtime-servicesمسارات وقت تشغيل Plugin المدعومة بالخدمات؛ تتضمن OpenWebUI عند الطلب.
plugins-runtime-install-a through plugins-runtime-install-hدُفعات تثبيت/وقت تشغيل Plugin مقسمة للتحقق المتوازي من الإصدار.
bundled-channels-coreسلوك Docker للقنوات المضمّنة.
bundled-channels-update-a, bundled-channels-update-discord, bundled-channels-update-bسلوك تحديث القنوات المضمّنة.
bundled-channels-contractsفحوص عقود القنوات المضمّنة في مسار إصدار Docker.
استخدم docker_lanes=<lane[,lane]> الموجّه في سير عمل المباشر/E2E القابل لإعادة الاستخدام عندما يفشل مسار Docker واحد فقط. تتضمن آثار الإصدار أوامر إعادة تشغيل لكل مسار مع مُدخلات إعادة استخدام أثر الحزمة والصورة عند توفرها.

​
ملفات تعريف الإصدار

يتحكم release_profile فقط في نطاق المباشر/الموفر داخل فحوصات الإصدار. وهو لا يزيل CI الكامل المعتاد، أو Plugin Prerelease، أو install smoke، أو قبول الحزمة، أو QA Lab، أو أجزاء مسار إصدار Docker.
ملف التعريفالاستخدام المقصودتغطية المباشر/الموفر المضمنة
minimumأسرع اختبار smoke حرج للإصدار.مسار OpenAI/core المباشر، ونماذج Docker المباشرة لـ OpenAI، وGateway الأصلي الأساسي، وملف تعريف Gateway الأصلي لـ OpenAI، وPlugin الأصلي لـ OpenAI، وGateway Docker المباشر لـ OpenAI.
stableملف تعريف اعتماد الإصدار الافتراضي.minimum بالإضافة إلى Anthropic، وGoogle، وMiniMax، والخلفية، وحزمة اختبار المباشر الأصلية، وخلفية CLI المباشرة في Docker، وربط Docker ACP، وحزمة اختبار Docker Codex، وشريحة smoke لـ OpenCode Go.
fullمسح استشاري واسع.stable بالإضافة إلى موفري الاستشارة، وشرائح Plugin المباشرة، وشرائح الوسائط المباشرة.

​
إضافات full فقط

تتخطى stable هذه الحزم وتضمّنها full:
المجالتغطية full فقط
نماذج Docker المباشرةOpenCode Go، وOpenRouter، وxAI، وZ.ai، وFireworks.
Gateway Docker المباشرشريحة استشارية لـ DeepSeek، وFireworks، وOpenCode Go، وOpenRouter، وxAI، وZ.ai.
ملفات تعريف موفر Gateway الأصليFireworks، وDeepSeek، وشرائح نماذج OpenCode Go الكاملة، وOpenRouter، وxAI، وZ.ai.
شرائح Plugin الأصلية المباشرةPlugins A-K، وL-N، وO-Z أخرى، وMoonshot، وxAI.
شرائح الوسائط الأصلية المباشرةالصوت، وموسيقى Google، وموسيقى MiniMax، ومجموعات الفيديو A-D.
تتضمن stable المسار native-live-src-gateway-profiles-opencode-go-smoke؛ أما full فتستخدم شرائح نماذج OpenCode Go الأوسع بدلا من ذلك.

​
عمليات إعادة تشغيل مركزة

استخدم rerun_group لتجنب تكرار صناديق إصدار غير مرتبطة:
المقبضالنطاق
allجميع مراحل التحقق الكامل من الإصدار.
ciفرع CI الكامل اليدوي فقط.
plugin-prereleaseفرع Plugin Prerelease فقط.
release-checksجميع مراحل فحوصات إصدار OpenClaw.
install-smokeInstall Smoke عبر فحوصات الإصدار.
cross-osفحوصات إصدار عبر أنظمة التشغيل.
live-e2eالتحقق من E2E للمستودع/المباشر ومسار إصدار Docker.
packageقبول الحزمة.
qaتكافؤ QA بالإضافة إلى مسارات QA المباشرة.
qa-parityمسارات تكافؤ QA والتقرير فقط.
qa-liveمصفوفة QA المباشرة وTelegram فقط.
npm-telegramTelegram E2E الاختياري بعد النشر فقط.
استخدم live_suite_filter مع rerun_group=live-e2e عندما تفشل حزمة مباشرة واحدة. تُعرّف معرّفات التصفية الصالحة في سير عمل المباشر/E2E القابل لإعادة الاستخدام، بما في ذلك docker-live-models، وlive-gateway-docker، وlive-gateway-anthropic-docker، وlive-gateway-google-docker، وlive-gateway-minimax-docker، وlive-gateway-advisory-docker، وlive-cli-backend-docker، وlive-acp-bind-docker، و live-codex-harness-docker.

​
الأدلة التي يجب الاحتفاظ بها

احتفظ بملخص Full Release Validation باعتباره فهرس مستوى الإصدار. فهو يربط معرّفات التشغيل الفرعية ويتضمن جداول أبطأ المهام. عند حدوث إخفاقات، افحص سير العمل الفرعي أولا، ثم أعد تشغيل أصغر مقبض مطابق أعلاه. آثار مفيدة:
  • release-package-under-test من OpenClaw Release Checks
  • آثار مسار إصدار Docker ضمن .artifacts/docker-tests/
  • package-under-test لقبول الحزمة وآثار قبول Docker
  • آثار فحص الإصدار عبر أنظمة التشغيل لكل نظام تشغيل وحزمة
  • آثار تكافؤ QA وMatrix وTelegram

​
ملفات سير العمل

  • .github/workflows/full-release-validation.yml
  • .github/workflows/openclaw-release-checks.yml
  • .github/workflows/openclaw-live-and-e2e-checks-reusable.yml
  • .github/workflows/plugin-prerelease.yml
  • .github/workflows/install-smoke.yml
  • .github/workflows/openclaw-cross-os-release-checks-reusable.yml
  • .github/workflows/package-acceptance.yml