Validasi rilis lengkap

Full Release Validation adalah payung rilis. Ini adalah satu-satunya entrypoint manual untuk bukti prarilis, tetapi sebagian besar pekerjaan terjadi di alur kerja anak sehingga kotak yang gagal dapat dijalankan ulang tanpa memulai ulang seluruh rilis. Jalankan dari ref alur kerja tepercaya, biasanya main, dan teruskan branch rilis, tag, atau SHA commit lengkap sebagai 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

Alur kerja anak menggunakan ref alur kerja tepercaya untuk harness dan input ref untuk kandidat yang diuji. Ini menjaga logika validasi baru tetap tersedia saat memvalidasi branch atau tag rilis yang lebih lama. Secara default, release_profile=stable menjalankan lane yang memblokir rilis dan melewati soak live/Docker yang menyeluruh. Teruskan run_release_soak=true untuk menyertakan lane soak pada proses stable. release_profile=full selalu mengaktifkan lane soak sehingga profil advisori yang luas tidak pernah kehilangan cakupan secara diam-diam. Package Acceptance biasanya membangun tarball kandidat dari ref yang di-resolve, termasuk proses dengan SHA lengkap yang di-dispatch menggunakan pnpm ci:full-release. Setelah publikasi beta, teruskan release_package_spec=openclaw@YYYY.M.D-beta.N untuk menggunakan kembali paket npm yang sudah dikirim di seluruh pemeriksaan rilis, Package Acceptance, lintas-OS, Docker jalur rilis, dan paket Telegram. Gunakan package_acceptance_package_spec hanya saat Package Acceptance memang sengaja harus membuktikan paket yang berbeda.

Tahap tingkat atas

Tahap	Detail
Resolusi target	Pekerjaan: `Resolve target ref` Alur kerja anak: tidak ada Membuktikan: me-resolve branch rilis, tag, atau SHA commit lengkap dan mencatat input yang dipilih. Jalankan ulang: jalankan ulang payung jika ini gagal.
Vitest dan CI normal	Pekerjaan: `Run normal full CI` Alur kerja anak: `CI` Membuktikan: grafik CI penuh manual terhadap ref target, termasuk lane Linux Node, shard Plugin bawaan, kontrak channel, kompatibilitas Node 22, `check`, `check-additional`, smoke build, pemeriksaan docs, Skills Python, Windows, macOS, i18n UI Kontrol, dan Android melalui payung. Jalankan ulang: `rerun_group=ci`.
Prarilis Plugin	Pekerjaan: `Run plugin prerelease validation` Alur kerja anak: `Plugin Prerelease` Membuktikan: pemeriksaan statis Plugin khusus rilis, cakupan Plugin agentik, shard batch ekstensi penuh, lane Docker prarilis Plugin, dan artefak `plugin-inspector-advisory` non-blocking untuk triase kompatibilitas. Jalankan ulang: `rerun_group=plugin-prerelease`.
Pemeriksaan rilis	Pekerjaan: `Run release/live/Docker/QA validation` Alur kerja anak: `OpenClaw Release Checks` Membuktikan: smoke install, pemeriksaan paket lintas-OS, Package Acceptance, paritas QA Lab, Matrix live, dan Telegram live. Dengan `run_release_soak=true` atau `release_profile=full`, juga menjalankan suite live/E2E menyeluruh dan chunk Docker jalur rilis. Jalankan ulang: `rerun_group=release-checks` atau handle release-checks yang lebih sempit.
Artefak paket	Pekerjaan: `Prepare release package artifact` Alur kerja anak: tidak ada Membuktikan: membuat tarball induk `release-package-under-test` cukup awal untuk pemeriksaan yang menghadap paket dan tidak perlu menunggu `OpenClaw Release Checks`. Jalankan ulang: jalankan ulang payung atau berikan `release_package_spec` untuk menjalankan ulang paket yang sudah dipublikasikan.
Paket Telegram	Pekerjaan: `Run package Telegram E2E` Alur kerja anak: `NPM Telegram Beta E2E` Membuktikan: bukti paket Telegram berbasis artefak induk untuk `rerun_group=all` dengan `release_profile=full`, atau bukti Telegram paket yang sudah dipublikasikan saat `release_package_spec` atau `npm_telegram_package_spec` ditetapkan. Jalankan ulang: `rerun_group=npm-telegram` dengan `release_package_spec` atau `npm_telegram_package_spec`.
Pemverifikasi payung	Pekerjaan: `Verify full validation` Alur kerja anak: tidak ada Membuktikan: memeriksa ulang kesimpulan proses anak yang tercatat dan menambahkan tabel pekerjaan paling lambat dari alur kerja anak. Jalankan ulang: jalankan ulang hanya pekerjaan ini setelah menjalankan ulang anak yang gagal hingga hijau.

Untuk ref=main dan rerun_group=all, payung yang lebih baru menggantikan yang lebih lama. Saat induk dibatalkan, monitornya membatalkan alur kerja anak apa pun yang sudah di-dispatch. Proses validasi branch dan tag rilis tidak membatalkan satu sama lain secara default.

Tahap pemeriksaan rilis

OpenClaw Release Checks adalah alur kerja anak terbesar. Ini me-resolve target satu kali dan menyiapkan artefak bersama release-package-under-test saat tahap yang menghadap paket atau Docker membutuhkannya.

Tahap	Detail
Target rilis	Job: `Resolve target ref` Workflow pendukung: tidak ada Pengujian: ref yang dipilih, SHA yang diharapkan opsional, profil, grup rerun, dan filter suite live terfokus. Rerun: `rerun_group=release-checks`.
Artefak paket	Job: `Prepare release package artifact` Workflow pendukung: tidak ada Pengujian: mengemas atau menyelesaikan satu kandidat tarball dan mengunggah `release-package-under-test` untuk pemeriksaan hilir yang berhadapan dengan paket. Rerun: paket, lintas-OS, atau grup live/E2E yang terdampak.
Smoke instalasi	Job: `Run install smoke` Workflow pendukung: `Install Smoke` Pengujian: jalur instalasi penuh dengan penggunaan ulang image smoke Dockerfile root, instalasi paket QR, smoke Docker root dan Gateway, pengujian Docker penginstal, smoke penyedia image instalasi global Bun, dan E2E instalasi/uninstalasi Plugin bawaan cepat. Rerun: `rerun_group=install-smoke`.
Lintas-OS	Job: `cross_os_release_checks` Workflow pendukung: `OpenClaw Cross-OS Release Checks (Reusable)` Pengujian: lane fresh dan upgrade pada Linux, Windows, dan macOS untuk penyedia dan mode yang dipilih, menggunakan kandidat tarball plus paket baseline. Rerun: `rerun_group=cross-os`.
Repo dan E2E live	Job: `Run repo/live E2E validation` Workflow pendukung: `OpenClaw Live And E2E Checks (Reusable)` Pengujian: E2E repositori, cache live, streaming websocket OpenAI, shard penyedia live native dan Plugin, serta harness model/backend/Gateway live berbasis Docker yang dipilih oleh `release_profile`. Berjalan: `run_release_soak=true`, `release_profile=full`, atau `rerun_group=live-e2e` terfokus. Rerun: `rerun_group=live-e2e`, opsional dengan `live_suite_filter`.
Jalur rilis Docker	Job: `Run Docker release-path validation` Workflow pendukung: `OpenClaw Live And E2E Checks (Reusable)` Pengujian: chunk Docker jalur rilis terhadap artefak paket bersama. Berjalan: `run_release_soak=true`, `release_profile=full`, atau `rerun_group=live-e2e` terfokus. Rerun: `rerun_group=live-e2e`.
Package Acceptance	Job: `Run package acceptance` Workflow pendukung: `Package Acceptance` Pengujian: fixture paket Plugin offline, pembaruan Plugin, package acceptance Telegram mock-OpenAI, dan pemeriksaan survivor upgrade terpublikasi terhadap tarball yang sama. Pemeriksaan rilis pemblokir menggunakan baseline terpublikasi terbaru default; pemeriksaan soak diperluas ke setiap rilis npm stabil pada atau setelah `2026.4.23` plus fixture masalah yang dilaporkan. Rerun: `rerun_group=package`.
Paritas QA	Job: `Run QA Lab parity lane` dan `Run QA Lab parity report` Workflow pendukung: job langsung Pengujian: pack paritas agentic kandidat dan baseline, lalu laporan paritas. Rerun: `rerun_group=qa-parity` atau `rerun_group=qa`.
Matrix live QA	Job: `Run QA Lab live Matrix lane` Workflow pendukung: job langsung Pengujian: profil QA Matrix live cepat di lingkungan `qa-live-shared`. Rerun: `rerun_group=qa-live` atau `rerun_group=qa`.
Telegram live QA	Job: `Run QA Lab live Telegram lane` Workflow pendukung: job langsung Pengujian: QA Telegram live dengan lease kredensial CI Convex. Rerun: `rerun_group=qa-live` atau `rerun_group=qa`.
Pemverifikasi rilis	Job: `Verify release checks` Workflow pendukung: tidak ada Pengujian: job pemeriksaan rilis wajib untuk grup rerun yang dipilih. Rerun: rerun setelah job anak terfokus lolos.

Chunk jalur rilis Docker

Tahap jalur rilis Docker menjalankan chunk ini saat live_suite_filter kosong:

Chunk	Cakupan
`core`	Lane smoke jalur rilis Docker inti.
`package-update-openai`	Perilaku instalasi/pembaruan paket OpenAI, instalasi Codex sesuai permintaan, dan panggilan alat Chat Completions.
`package-update-anthropic`	Perilaku instalasi dan pembaruan paket Anthropic.
`package-update-core`	Perilaku paket dan pembaruan yang netral penyedia.
`plugins-runtime-plugins`	Lane runtime Plugin yang menjalankan perilaku Plugin.
`plugins-runtime-services`	Lane runtime Plugin berbasis layanan dan live; mencakup OpenWebUI saat diminta.
`plugins-runtime-install-a` hingga `plugins-runtime-install-h`	Batch instalasi/runtime Plugin yang dipisah untuk validasi rilis paralel.

Gunakan docker_lanes=<lane[,lane]> yang ditargetkan pada workflow live/E2E reusable saat hanya satu lane Docker yang gagal. Artefak rilis menyertakan perintah rerun per lane dengan input artefak paket dan penggunaan ulang image saat tersedia.

Profil rilis

release_profile terutama mengontrol cakupan live/penyedia di dalam pemeriksaan rilis. Ini tidak menghapus CI penuh normal, Plugin Prerelease, smoke instalasi, package acceptance, atau QA Lab. Untuk stable, E2E repo/live yang menyeluruh dan chunk jalur rilis Docker adalah cakupan soak dan berjalan saat run_release_soak=true. full memaksa cakupan soak aktif dan juga membuat umbrella menjalankan E2E paket Telegram terhadap artefak paket rilis induk saat rerun_group=all, sehingga kandidat pra-publikasi penuh tidak diam-diam melewati lane paket Telegram tersebut.

Profil	Penggunaan yang dimaksudkan	Cakupan live/penyedia yang disertakan
`minimum`	Smoke kritis rilis tercepat.	Jalur live OpenAI/core, model live Docker untuk OpenAI, core Gateway native, profil Gateway OpenAI native, Plugin OpenAI native, dan Gateway live Docker OpenAI.
`stable`	Profil persetujuan rilis default.	`minimum` plus smoke Anthropic, Google, MiniMax, backend, harness pengujian live native, backend CLI live Docker, bind ACP Docker, harness Codex Docker, dan shard smoke OpenCode Go.
`full`	Sweep advisory luas.	`stable` plus penyedia advisory, shard live Plugin, dan shard live media.

Tambahan khusus full

Suite ini dilewati oleh stable dan disertakan oleh full:

Area	Cakupan khusus full
Model live Docker	OpenCode Go, OpenRouter, xAI, Z.ai, dan Fireworks.
Gateway live Docker	Penyedia advisory dipisah menjadi shard DeepSeek/Fireworks, OpenCode Go/OpenRouter, dan xAI/Z.ai.
Profil penyedia Gateway native	Shard lengkap Anthropic Opus dan Sonnet/Haiku, Fireworks, DeepSeek, shard model OpenCode Go lengkap, OpenRouter, xAI, dan Z.ai.
Shard live Plugin native	Plugin A-K, L-N, O-Z lainnya, Moonshot, dan xAI.
Shard live media native	Grup audio, musik Google, musik MiniMax, dan video A-D.

stable menyertakan native-live-src-gateway-profiles-anthropic-smoke dan native-live-src-gateway-profiles-opencode-go-smoke; full menggunakan shard model Anthropic dan OpenCode Go yang lebih luas sebagai gantinya. Rerun terfokus tetap dapat menggunakan handle agregat native-live-src-gateway-profiles-anthropic atau native-live-src-gateway-profiles-opencode-go.

Rerun terfokus

Gunakan rerun_group untuk menghindari pengulangan kotak rilis yang tidak terkait:

Handle	Cakupan
`all`	Semua tahap Validasi Rilis Penuh.
`ci`	Hanya turunan CI penuh manual.
`plugin-prerelease`	Hanya turunan Prarilis Plugin.
`release-checks`	Semua tahap Pemeriksaan Rilis OpenClaw.
`install-smoke`	Uji smoke instalasi melalui pemeriksaan rilis.
`cross-os`	Pemeriksaan rilis lintas OS.
`live-e2e`	Validasi E2E repo/live dan jalur rilis Docker.
`package`	Penerimaan Paket.
`qa`	Paritas QA ditambah jalur live QA.
`qa-parity`	Hanya jalur dan laporan paritas QA.
`qa-live`	Hanya Matrix dan Telegram live QA.
`npm-telegram`	E2E Telegram paket terpublikasi; memerlukan `release_package_spec` atau `npm_telegram_package_spec`.

Gunakan live_suite_filter dengan rerun_group=live-e2e ketika satu suite live gagal. Id filter yang valid didefinisikan dalam workflow live/E2E yang dapat digunakan kembali, termasuk 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, dan live-codex-harness-docker. Handle live-gateway-advisory-docker adalah handle rerun agregat untuk tiga shard providernya, sehingga tetap menyebar ke semua tugas Gateway Docker advisory. Gunakan cross_os_suite_filter dengan rerun_group=cross-os ketika satu jalur lintas OS gagal. Filter menerima id OS, id suite, atau pasangan OS/suite, misalnya windows/packaged-upgrade, windows, atau packaged-fresh. Ringkasan lintas OS menyertakan waktu per fase untuk jalur upgrade terpaket, dan perintah yang berjalan lama mencetak baris Heartbeat sehingga pembaruan Windows yang macet terlihat sebelum timeout tugas. Jalur pemeriksaan rilis QA bersifat advisory. Kegagalan hanya QA dilaporkan sebagai peringatan dan tidak memblokir verifier pemeriksaan rilis; jalankan ulang rerun_group=qa, qa-parity, atau qa-live ketika Anda membutuhkan bukti QA baru.

Bukti yang perlu disimpan

Simpan ringkasan Full Release Validation sebagai indeks tingkat rilis. Ringkasan ini menautkan id run turunan dan menyertakan tabel tugas paling lambat. Untuk kegagalan, periksa workflow turunan terlebih dahulu, lalu jalankan ulang handle terkecil yang sesuai di atas. Artefak berguna:

release-package-under-test dari induk Validasi Rilis Penuh dan OpenClaw Release Checks
Artefak jalur rilis Docker di bawah .artifacts/docker-tests/
Artefak Penerimaan Paket package-under-test dan penerimaan Docker
Artefak pemeriksaan rilis lintas OS untuk setiap OS dan suite
Artefak paritas QA, Matrix, dan Telegram

File workflow

.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

Documentation Index

​Tahap tingkat atas

​Tahap pemeriksaan rilis

​Chunk jalur rilis Docker

​Profil rilis

​Tambahan khusus full

​Rerun terfokus

​Bukti yang perlu disimpan

​File workflow