مسار CI

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.

​

نظرة عامة على خط الأنابيب

​

ترتيب الفشل السريع

1. يقرر preflight أي المسارات توجد أصلا. منطق docs-scope وchanged-scope خطوات داخل هذه المهمة، وليسا مهمتين مستقلتين.
2. تفشل security-scm-fast، وsecurity-dependency-audit، وsecurity-fast، وcheck، وcheck-additional، وcheck-docs، وskills-python بسرعة دون انتظار مهام الآثار الأثقل ومصفوفة المنصات.
3. تتداخل build-artifacts مع مسارات Linux السريعة حتى يمكن للمستهلكين في المصب البدء بمجرد أن يصبح البناء المشترك جاهزا.
4. تتوسع مسارات المنصات ووقت التشغيل الأثقل بعد ذلك: checks-fast-core، وchecks-fast-contracts-channels، وchecks-node-core-test، وchecks، وchecks-windows، وmacos-node، وmacos-swift، وandroid.

​

النطاق والتوجيه

• تعديلات سير عمل CI تتحقق من رسم CI الخاص بـ Node بالإضافة إلى فحص سير العمل، لكنها لا تفرض وحدها عمليات بناء Windows أو Android أو macOS الأصلية؛ تبقى تلك المسارات الخاصة بالمنصات محددة النطاق لتغييرات مصدر المنصة.
• تعديلات توجيه CI فقط، وتعديلات تجهيزات اختبارات core-test رخيصة مختارة، وتعديلات مساعدين/توجيه اختبارات عقود Plugin الضيقة تستخدم مسار بيان سريع خاص بـ Node فقط: preflight، والأمان، ومهمة checks-fast-core واحدة. يتخطى ذلك المسار آثار البناء، وتوافق Node 22، وعقود القنوات، وأجزاء النواة الكاملة، وأجزاء Plugin المجمعة، ومصفوفات الحراس الإضافية عندما يكون التغيير مقتصرا على أسطح التوجيه أو المساعدين التي تمارسها المهمة السريعة مباشرة.
• فحوصات Windows Node محددة النطاق لأغلفة العمليات/المسارات الخاصة بـ Windows، ومساعدي مشغلات npm/pnpm/UI، وتكوين مدير الحزم، وأسطح سير عمل CI التي تنفذ ذلك المسار؛ تبقى تغييرات المصدر، وPlugin، وinstall-smoke، والاختبارات فقط غير ذات الصلة على مسارات Linux Node.

​

تمرير نشاط ClawSweeper

• clawsweeper_item لطلبات مراجعة القضايا وطلبات السحب الدقيقة؛
• clawsweeper_comment لأوامر ClawSweeper الصريحة في تعليقات القضايا؛
• clawsweeper_commit_review لطلبات المراجعة على مستوى الالتزام في دفعات main؛
• github_activity لنشاط GitHub العام الذي قد يتفقده وكيل ClawSweeper.

​

عمليات الإطلاق اليدوية

gh workflow run ci.yml --ref release/YYYY.M.D
gh workflow run ci.yml --ref main -f target_ref=<branch-or-sha> -f include_android=true
gh workflow run full-release-validation.yml --ref main -f ref=<branch-or-sha>

​

المشغّلات

​

المكافئات المحلية

pnpm changed:lanes                            # inspect the local changed-lane classifier for origin/main...HEAD
pnpm check:changed                            # smart local check gate: changed typecheck/lint/guards by boundary lane
pnpm check                                    # fast local gate: prod tsgo + sharded lint + parallel fast guards
pnpm check:test-types
pnpm check:timed                              # same gate with per-stage timings
pnpm build:strict-smoke
pnpm check:architecture
pnpm test:gateway:watch-regression
pnpm test                                     # vitest tests
pnpm test:changed                             # cheap smart changed Vitest targets
pnpm test:channels
pnpm test:contracts:channels
pnpm check:docs                               # docs format + lint + broken links
pnpm build                                    # build dist when CI artifact/build-smoke lanes matter
pnpm ci:timings                               # summarize the latest origin/main push CI run
pnpm ci:timings:recent                        # compare recent successful main CI runs
node scripts/ci-run-timings.mjs <run-id>      # summarize wall time, queue time, and slowest jobs
node scripts/ci-run-timings.mjs --latest-main # ignore issue/comment noise and choose origin/main push CI
node scripts/ci-run-timings.mjs --recent 10   # compare recent successful main CI runs
pnpm test:perf:groups --full-suite --allow-failures --output .artifacts/test-perf/baseline-before.json
pnpm test:perf:groups:compare .artifacts/test-perf/baseline-before.json .artifacts/test-perf/after-agent.json
pnpm perf:kova:summary --report .artifacts/kova/reports/mock-provider/report.json --output .artifacts/kova/summary.md

​

أداء OpenClaw

gh workflow run openclaw-performance.yml --ref main -f profile=diagnostic -f repeat=3
gh workflow run openclaw-performance.yml --ref main -f profile=smoke -f repeat=1 -f deep_profile=true -f live_gpt54=true
gh workflow run openclaw-performance.yml --ref main -f target_ref=v2026.5.2 -f profile=diagnostic -f repeat=3

• mock-provider: سيناريوهات Kova التشخيصية مقابل وقت تشغيل بناء محلي بمصادقة وهمية حتمية متوافقة مع OpenAI.
• mock-deep-profile: تحليل CPU/heap/trace لمواضع بدء التشغيل وGateway ودورة الوكيل الساخنة.
• live-gpt54: دورة وكيل OpenAI openai/gpt-5.4 حقيقية، تُتخطى عندما لا يتوفر OPENAI_API_KEY.

​

التحقق الكامل من الإصدار

gh workflow run openclaw-release-publish.yml \
  --ref release/YYYY.M.D \
  -f tag=vYYYY.M.D-beta.N \
  -f preflight_run_id=<successful-openclaw-npm-preflight-run-id> \
  -f npm_dist_tag=beta

pnpm ci:full-release --sha <full-sha>

• يحافظ minimum على أسرع مسارات OpenAI/النواة الحرجة للإصدار.
• يضيف stable مجموعة المزوّد/الخلفية المستقرة.
• يشغّل full مصفوفة المزوّد/الوسائط الاستشارية الواسعة.

​

أجزاء live وE2E

• native-live-src-agents
• native-live-src-gateway-core
• مهام native-live-src-gateway-profiles المفلترة حسب المزوّد
• native-live-src-gateway-backends
• native-live-test
• native-live-extensions-a-k
• native-live-extensions-l-n
• native-live-extensions-openai
• native-live-extensions-o-z-other
• native-live-extensions-xai
• أجزاء وسائط الصوت/الفيديو المقسمة وأجزاء الموسيقى المفلترة حسب المزوّد

​

قبول الحزمة

​

المهام

1. يفحص resolve_package ‏workflow_ref، ويحل مرشح حزمة واحدًا، ويكتب .artifacts/docker-e2e-package/openclaw-current.tgz، ويكتب .artifacts/docker-e2e-package/package-candidate.json، ويرفعهما معًا كأثر package-under-test، ويطبع المصدر ومرجع workflow ومرجع الحزمة والإصدار وSHA-256 والملف الشخصي في ملخص خطوة GitHub.
2. يستدعي docker_acceptance ‏openclaw-live-and-e2e-checks-reusable.yml مع ref=workflow_ref وpackage_artifact_name=package-under-test. ينزّل workflow القابل لإعادة الاستخدام ذلك الأثر، ويتحقق من قائمة tarball، ويحضّر Docker images الخاصة بملخص الحزمة عند الحاجة، ويشغّل مسارات Docker المحددة ضد تلك الحزمة بدلًا من حزم checkout الخاص بالـworkflow. عندما يحدد ملف شخصي عدة docker_lanes مستهدفة، يحضّر workflow القابل لإعادة الاستخدام الحزمة وimages المشتركة مرة واحدة، ثم يوزع تلك المسارات كمهام Docker مستهدفة متوازية مع آثار فريدة.
3. يستدعي package_telegram اختياريًا NPM Telegram Beta E2E. يعمل عندما لا يكون telegram_mode هو none ويثبّت الأثر نفسه package-under-test عندما يحل Package Acceptance واحدًا؛ ولا يزال بإمكان تشغيل Telegram المستقل تثبيت مواصفة npm منشورة.
4. يفشل summary الـworkflow إذا فشل حل الحزمة أو قبول Docker أو مسار Telegram الاختياري.

​

مصادر المرشحين

• يقبل source=npm فقط openclaw@beta أو openclaw@latest أو إصدار OpenClaw دقيقًا مثل openclaw@2026.4.27-beta.2. استخدم هذا لقبول الإصدار التمهيدي/المستقر المنشور.
• يحزم source=ref فرعًا أو وسمًا أو SHA التزامًا كاملًا موثوقًا في package_ref. يجلب المحلّل فروع/وسوم OpenClaw، ويتحقق من أن الالتزام المحدد قابل للوصول من تاريخ فرع المستودع أو وسم إصدار، ويثبّت التبعيات في worktree منفصل، ويحزمه باستخدام scripts/package-openclaw-for-docker.mjs.
• ينزّل source=url ملف .tgz عبر HTTPS؛ وتكون package_sha256 مطلوبة.
• ينزّل source=artifact ملف .tgz واحدًا من artifact_run_id وartifact_name؛ تكون package_sha256 اختيارية لكنها يجب أن تُقدَّم للآثار المشتركة خارجيًا.

​

ملفات تعريف المجموعة

• smoke — npm-onboard-channel-agent، gateway-network، config-reload
• package — npm-onboard-channel-agent، doctor-switch، update-channel-switch، skill-install، update-corrupt-plugin، upgrade-survivor، published-upgrade-survivor، update-restart-auth، plugins-offline، plugin-update
• product — package إضافة إلى mcp-channels، cron-mcp-cleanup، openai-web-search-minimal، openwebui
• full — أجزاء مسار إصدار Docker الكاملة مع OpenWebUI
• custom — docker_lanes الدقيقة؛ مطلوبة عندما يكون suite_profile=custom

​

نوافذ التوافق القديم

• قد تشير إدخالات QA الخاصة المعروفة في dist/postinstall-inventory.json إلى ملفات محذوفة من ملف tarball؛
• قد يتخطى doctor-switch الحالة الفرعية لاستمرارية gateway install --wrapper عندما لا تعرض الحزمة ذلك الخيار؛
• قد يزيل update-channel-switch تبعيات pnpm patchedDependencies المفقودة من تجهيز git الوهمي المشتق من tarball، وقد يسجل فقدان update.channel المستمر؛
• قد تقرأ فحوصات دخان Plugin مواقع سجلات التثبيت القديمة أو تقبل غياب استمرارية سجل تثبيت marketplace؛
• قد يسمح plugin-update بترحيل بيانات تعريف الإعداد مع الاستمرار في اشتراط بقاء سجل التثبيت وسلوك عدم إعادة التثبيت دون تغيير.

​

أمثلة

# Validate the current beta package with product-level coverage.
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=npm \
  -f package_spec=openclaw@beta \
  -f suite_profile=product \
  -f telegram_mode=mock-openai

# Pack and validate a release branch with the current harness.
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=ref \
  -f package_ref=release/YYYY.M.D \
  -f suite_profile=package \
  -f telegram_mode=mock-openai

# Validate a tarball URL. SHA-256 is mandatory for source=url.
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=url \
  -f package_url=https://example.com/openclaw-current.tgz \
  -f package_sha256=<64-char-sha256> \
  -f suite_profile=smoke

# Reuse a tarball uploaded by another Actions run.
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=artifact \
  -f artifact_run_id=<run-id> \
  -f artifact_name=package-under-test \
  -f suite_profile=custom \
  -f docker_lanes='install-e2e plugin-update'

​

دخان التثبيت

• المسار السريع يعمل لطلبات السحب التي تمس أسطح Docker/الحزمة، أو تغييرات حزمة/بيان Plugin المضمّنة، أو أسطح Plugin/القناة/Gateway/Plugin SDK الأساسية التي تمارسها وظائف دخان Docker. لا تحجز تغييرات Plugin المضمّنة المصدرية فقط، أو تعديلات الاختبارات فقط، أو تعديلات التوثيق فقط عمال Docker. يبني المسار السريع صورة Dockerfile الجذر مرة واحدة، ويفحص CLI، ويشغّل دخان CLI لحذف الوكلاء في مساحة العمل المشتركة، ويشغّل اختبار e2e لشبكة Gateway في الحاوية، ويتحقق من وسيطة بناء إضافة مضمّنة، ويشغّل ملف تعريف Docker المحدود لـ Plugin المضمّن تحت مهلة إجمالية للأمر مقدارها 240 ثانية (مع حد مستقل لكل تشغيل Docker في كل سيناريو).
• المسار الكامل يحتفظ بتغطية تثبيت حزمة QR وDocker/التحديث للمثبّت للتشغيلات الليلية المجدولة، والتشغيلات اليدوية، وفحوصات إصدار workflow-call، وطلبات السحب التي تمس فعلًا أسطح المثبّت/الحزمة/Docker. في الوضع الكامل، يجهز install-smoke أو يعيد استخدام صورة دخان Dockerfile جذر GHCR واحدة لهدف SHA، ثم يشغّل تثبيت حزمة QR، وفحوصات دخان Dockerfile/Gateway الجذر، وفحوصات دخان المثبّت/التحديث، وDocker E2E السريع لـ Plugin المضمّن كوظائف منفصلة حتى لا ينتظر عمل المثبّت خلف فحوصات دخان الصورة الجذرية.

​

Docker E2E المحلي

• مشغّل Node/Git مجرد لمسارات المثبّت/التحديث/تبعية Plugin؛
• صورة وظيفية تثبّت ملف tarball نفسه في /app لمسارات الوظائف العادية.

​

إعدادات قابلة للضبط

​

سير عمل حي/E2E قابل لإعادة الاستخدام

​

أجزاء مسار الإصدار

• OPENCLAW_DOCKER_ALL_PROFILE=release-path
• OPENCLAW_DOCKER_ALL_CHUNK=core | package-update-openai | package-update-anthropic | package-update-core | plugins-runtime-plugins | plugins-runtime-services | plugins-runtime-install-a..h

pnpm test:docker:rerun <run-id>      # تنزيل آثار Docker وطباعة أوامر إعادة التشغيل المستهدفة المجمّعة/لكل مسار
pnpm test:docker:timings <summary>   # ملخصات المسارات البطيئة والمسار الحرج للمراحل

​

الإصدار التمهيدي لـ Plugin

​

مختبر ضمان الجودة

• يشغّل سير العمل QA-Lab - All Lanes ليلًا على main وعند الإرسال اليدوي؛ ويفرّع مسار تكافؤ المحاكاة، ومسار Matrix الحي، ومساري Telegram وDiscord الحيين كمهام متوازية. تستخدم المهام الحية بيئة qa-live-shared، ويستخدم Telegram/Discord حجوزات Convex.

​

CodeQL

​

فئات الأمان

​

شظايا الأمان الخاصة بالمنصات

• CodeQL Android Critical Security — شظية أمان Android مجدولة. تبني تطبيق Android يدويًا لـ CodeQL على أصغر مشغّل Blacksmith Linux تقبله سلامة سير العمل. ترفع تحت /codeql-critical-security/android.
• CodeQL macOS Critical Security — شظية أمان macOS أسبوعية/يدوية. تبني تطبيق macOS يدويًا لـ CodeQL على Blacksmith macOS، وتستبعد نتائج بناء التبعيات من SARIF المرفوع، وترفع تحت /codeql-critical-security/macos. تُبقى خارج الإعدادات اليومية الافتراضية لأن بناء macOS يهيمن على وقت التشغيل حتى عندما يكون نظيفًا.

​

فئات الجودة الحرجة

profile=all|agent-runtime-boundary|config-boundary|core-auth-secrets|channel-runtime-boundary|gateway-runtime-boundary|memory-runtime-boundary|mcp-process-runtime-boundary|plugin-boundary|plugin-sdk-package-contract|plugin-sdk-reply-runtime|provider-runtime-boundary|session-diagnostics-boundary

​

سير عمل الصيانة

​

وكيل المستندات

​

وكيل أداء الاختبار

​

طلبات PR المكررة بعد الدمج

gh workflow run duplicate-after-merge.yml \
  -f landed_pr=70532 \
  -f duplicate_prs='70530,70592' \
  -f apply=true

​

بوابات الفحص المحلية والتوجيه حسب التغييرات

• تغييرات إنتاج النواة تشغل فحص الأنواع لإنتاج النواة واختبارات النواة بالإضافة إلى فحص lint/الحراس للنواة؛
• تغييرات النواة الخاصة بالاختبارات فقط تشغل فحص أنواع اختبارات النواة فقط بالإضافة إلى lint النواة؛
• تغييرات إنتاج الإضافة تشغل فحص أنواع إنتاج الإضافة واختبارات الإضافة بالإضافة إلى lint الإضافة؛
• تغييرات الإضافة الخاصة بالاختبارات فقط تشغل فحص أنواع اختبارات الإضافة بالإضافة إلى lint الإضافة؛
• تغييرات Plugin SDK العامة أو عقد Plugin توسع إلى فحص أنواع الإضافات لأن الإضافات تعتمد على عقود النواة هذه (تبقى عمليات مسح إضافات Vitest عملا اختباريا صريحا)؛
• زيادات إصدار بيانات التعريف الخاصة بالإصدار فقط تشغل فحوصات إصدار/تكوين/تبعية جذرية مستهدفة؛
• تغييرات الجذر/التكوين غير المعروفة تفشل بأمان إلى كل مسارات الفحص.

​

تحقق Testbox

pnpm crabbox:run -- --help | sed -n '1,120p'

pnpm crabbox:run -- --provider blacksmith-testbox \
  --blacksmith-org openclaw \
  --blacksmith-workflow .github/workflows/ci-check-testbox.yml \
  --blacksmith-job check \
  --blacksmith-ref main \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "env CI=1 NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_TEST_PROJECTS_PARALLEL=6 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm check:changed"

pnpm crabbox:run -- --provider blacksmith-testbox \
  --blacksmith-org openclaw \
  --blacksmith-workflow .github/workflows/ci-check-testbox.yml \
  --blacksmith-job check \
  --blacksmith-ref main \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "env CI=1 NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm test <path-or-filter>"

pnpm crabbox:run -- --provider blacksmith-testbox \
  --blacksmith-org openclaw \
  --blacksmith-workflow .github/workflows/ci-check-testbox.yml \
  --blacksmith-job check \
  --blacksmith-ref main \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "env CI=1 NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_TEST_PROJECTS_PARALLEL=6 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm test"

blacksmith testbox list --all
blacksmith testbox status --id <tbx_id>
blacksmith testbox stop --id <tbx_id>

pnpm crabbox:run -- --provider blacksmith-testbox --id <tbx_id> --no-sync --timing-json --shell -- "pnpm test <path-or-filter>"
pnpm crabbox:stop -- <tbx_id>

CRABBOX_CAPACITY_REGIONS=eu-west-1,eu-west-2,eu-central-1,us-east-1,us-west-2 \
  pnpm crabbox:warmup -- --provider aws --class standard --market on-demand --idle-timeout 90m
pnpm crabbox:hydrate -- --id <cbx_id-or-slug>
pnpm crabbox:run -- --id <cbx_id-or-slug> --timing-json --shell -- "env NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_TEST_PROJECTS_PARALLEL=6 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm check:changed"
pnpm crabbox:stop -- <cbx_id-or-slug>

​

ذات صلة

• نظرة عامة على التثبيت
• قنوات التطوير