전체 릴리스 검증

Full Release Validation은 릴리스 검증을 총괄하는 상위 워크플로입니다. 프리릴리스 증명을 위한 단일 수동 진입점이지만, 대부분의 작업은 하위 워크플로에서 수행되므로 실패한 박스만 전체 릴리스를 다시 시작하지 않고 재실행할 수 있습니다. 신뢰할 수 있는 워크플로 ref(일반적으로 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를 사용하고, 테스트 대상 후보에는 입력 ref를 사용합니다. 이렇게 하면 더 오래된 릴리스 브랜치나 태그를 검증할 때도 새 검증 로직을 사용할 수 있습니다. 기본적으로 release_profile=stable은 릴리스 차단 레인을 실행하고 포괄적인 라이브/Docker soak는 건너뜁니다. stable 실행에 soak 레인을 포함하려면 run_release_soak=true를 전달합니다. release_profile=full은 항상 soak 레인을 활성화하므로 광범위한 권고 프로필이 조용히 커버리지를 잃지 않습니다. Package Acceptance는 일반적으로 해결된 ref에서 후보 tarball을 빌드하며, 여기에는 pnpm ci:full-release로 디스패치된 전체 SHA 실행도 포함됩니다. 베타 게시 후에는 release_package_spec=openclaw@YYYY.M.D-beta.N을 전달하여 릴리스 검사, Package Acceptance, 크로스 OS, 릴리스 경로 Docker, 패키지 Telegram 전반에서 배포된 npm 패키지를 재사용합니다. Package Acceptance가 의도적으로 다른 패키지를 증명해야 할 때만 package_acceptance_package_spec을 사용합니다.

최상위 단계

단계	세부 정보
대상 확인	작업: `Resolve target ref` 하위 워크플로: 없음 증명: 릴리스 브랜치, 태그 또는 전체 커밋 SHA를 확인하고 선택된 입력을 기록합니다. 재실행: 이 단계가 실패하면 상위 워크플로를 다시 실행합니다.
Vitest 및 일반 CI	작업: `Run normal full CI` 하위 워크플로: `CI` 증명: Linux Node 레인, 번들 Plugin 샤드, 채널 계약, Node 22 호환성, `check`, `check-additional`, 빌드 smoke, 문서 검사, Python Skills, Windows, macOS, Control UI i18n, 상위 워크플로를 통한 Android를 포함하여 대상 ref에 대해 수동 전체 CI 그래프를 검증합니다. 재실행: `rerun_group=ci`.
Plugin 프리릴리스	작업: `Run plugin prerelease validation` 하위 워크플로: `Plugin Prerelease` 증명: 릴리스 전용 Plugin 정적 검사, 에이전트형 Plugin 커버리지, 전체 확장 배치 샤드, Plugin 프리릴리스 Docker 레인, 호환성 트리아지를 위한 비차단 `plugin-inspector-advisory` 아티팩트를 검증합니다. 재실행: `rerun_group=plugin-prerelease`.
릴리스 검사	작업: `Run release/live/Docker/QA validation` 하위 워크플로: `OpenClaw Release Checks` 증명: 설치 smoke, 크로스 OS 패키지 검사, Package Acceptance, QA Lab 패리티, 라이브 Matrix, 라이브 Telegram을 검증합니다. `run_release_soak=true` 또는 `release_profile=full`이면 포괄적인 라이브/E2E 스위트와 Docker 릴리스 경로 청크도 실행합니다. 재실행: `rerun_group=release-checks` 또는 더 좁은 release-checks 핸들.
패키지 아티팩트	작업: `Prepare release package artifact` 하위 워크플로: 없음 증명: `OpenClaw Release Checks`를 기다릴 필요가 없는 패키지 대상 검사에 충분히 이른 시점에 부모 `release-package-under-test` tarball을 생성합니다. 재실행: 상위 워크플로를 다시 실행하거나 게시된 패키지 재실행에는 `release_package_spec`을 제공합니다.
패키지 Telegram	작업: `Run package Telegram E2E` 하위 워크플로: `NPM Telegram Beta E2E` 증명: `release_profile=full`인 `rerun_group=all`에 대해 부모 아티팩트 기반 Telegram 패키지 증명을 제공하거나, `release_package_spec` 또는 `npm_telegram_package_spec`이 설정된 경우 게시된 패키지 Telegram 증명을 제공합니다. 재실행: `release_package_spec` 또는 `npm_telegram_package_spec`과 함께 `rerun_group=npm-telegram`.
상위 검증기	작업: `Verify full validation` 하위 워크플로: 없음 증명: 기록된 하위 실행 결론을 다시 확인하고 하위 워크플로의 가장 느린 작업 표를 추가합니다. 재실행: 실패한 하위 워크플로를 다시 실행해 녹색 상태로 만든 뒤 이 작업만 다시 실행합니다.

ref=main 및 rerun_group=all의 경우, 더 새 상위 워크플로가 더 오래된 상위 워크플로를 대체합니다. 부모가 취소되면 해당 모니터는 이미 디스패치한 모든 하위 워크플로를 취소합니다. 릴리스 브랜치 및 태그 검증 실행은 기본적으로 서로를 취소하지 않습니다.

릴리스 검사 단계

OpenClaw Release Checks는 가장 큰 하위 워크플로입니다. 대상을 한 번 확인하고, 패키지 또는 Docker 대상 단계에 필요할 때 공유 release-package-under-test 아티팩트를 준비합니다.

단계	세부 정보
릴리스 대상	작업: `Resolve target ref` 지원 워크플로: 없음 테스트: 선택한 ref, 선택적 예상 SHA, 프로필, 재실행 그룹, 집중 라이브 스위트 필터. 재실행: `rerun_group=release-checks`.
패키지 아티팩트	작업: `Prepare release package artifact` 지원 워크플로: 없음 테스트: 후보 tarball 하나를 패킹하거나 확인하고, 다운스트림 패키지 대상 검사를 위해 `release-package-under-test`를 업로드합니다. 재실행: 영향을 받는 패키지, 크로스 OS 또는 라이브/E2E 그룹.
설치 스모크	작업: `Run install smoke` 지원 워크플로: `Install Smoke` 테스트: 루트 Dockerfile 스모크 이미지 재사용을 포함한 전체 설치 경로, QR 패키지 설치, 루트 및 Gateway Docker 스모크, 설치 관리자 Docker 테스트, Bun 전역 설치 이미지 제공자 스모크, 빠른 번들 Plugin 설치/제거 E2E. 재실행: `rerun_group=install-smoke`.
크로스 OS	작업: `cross_os_release_checks` 지원 워크플로: `OpenClaw Cross-OS Release Checks (Reusable)` 테스트: 후보 tarball과 기준 패키지를 사용하여 선택한 제공자와 모드에 대해 Linux, Windows, macOS에서 새 설치 및 업그레이드 레인을 실행합니다. 재실행: `rerun_group=cross-os`.
저장소 및 라이브 E2E	작업: `Run repo/live E2E validation` 지원 워크플로: `OpenClaw Live And E2E Checks (Reusable)` 테스트: 저장소 E2E, 라이브 캐시, OpenAI websocket 스트리밍, 네이티브 라이브 제공자 및 Plugin 샤드, `release_profile`이 선택한 Docker 기반 라이브 모델/백엔드/Gateway 하니스. 실행: `run_release_soak=true`, `release_profile=full` 또는 집중 `rerun_group=live-e2e`. 재실행: `rerun_group=live-e2e`, 선택적으로 `live_suite_filter` 포함.
Docker 릴리스 경로	작업: `Run Docker release-path validation` 지원 워크플로: `OpenClaw Live And E2E Checks (Reusable)` 테스트: 공유 패키지 아티팩트에 대한 릴리스 경로 Docker 청크. 실행: `run_release_soak=true`, `release_profile=full` 또는 집중 `rerun_group=live-e2e`. 재실행: `rerun_group=live-e2e`.
패키지 승인	작업: `Run package acceptance` 지원 워크플로: `Package Acceptance` 테스트: 오프라인 Plugin 패키지 픽스처, Plugin 업데이트, 모의 OpenAI Telegram 패키지 승인, 동일한 tarball에 대한 게시된 업그레이드 생존 검사. 차단 릴리스 검사는 기본 최신 게시 기준선을 사용하고, 소크 검사는 `2026.4.23` 이후의 모든 안정 npm 릴리스와 보고된 이슈 픽스처로 확장됩니다. 재실행: `rerun_group=package`.
QA 패리티	작업: `Run QA Lab parity lane` 및 `Run QA Lab parity report` 지원 워크플로: 직접 작업 테스트: 후보 및 기준 agentic 패리티 팩, 이후 패리티 보고서. 재실행: `rerun_group=qa-parity` 또는 `rerun_group=qa`.
QA 라이브 Matrix	작업: `Run QA Lab live Matrix lane` 지원 워크플로: 직접 작업 테스트: `qa-live-shared` 환경의 빠른 라이브 Matrix QA 프로필. 재실행: `rerun_group=qa-live` 또는 `rerun_group=qa`.
QA 라이브 Telegram	작업: `Run QA Lab live Telegram lane` 지원 워크플로: 직접 작업 테스트: Convex CI 자격 증명 임대를 사용하는 라이브 Telegram QA. 재실행: `rerun_group=qa-live` 또는 `rerun_group=qa`.
릴리스 검증기	작업: `Verify release checks` 지원 워크플로: 없음 테스트: 선택한 재실행 그룹에 필요한 릴리스 검사 작업. 재실행: 집중 하위 작업이 통과한 뒤 재실행합니다.

Docker 릴리스 경로 청크

Docker 릴리스 경로 단계는 live_suite_filter가 비어 있을 때 다음 청크를 실행합니다.

청크	범위
`core`	Core Docker 릴리스 경로 스모크 레인.
`package-update-openai`	OpenAI 패키지 설치/업데이트 동작, Codex 온디맨드 설치, Chat Completions 도구 호출.
`package-update-anthropic`	Anthropic 패키지 설치 및 업데이트 동작.
`package-update-core`	제공자 중립 패키지 및 업데이트 동작.
`plugins-runtime-plugins`	Plugin 동작을 실행하는 Plugin 런타임 레인.
`plugins-runtime-services`	서비스 기반 및 라이브 Plugin 런타임 레인. 요청 시 OpenWebUI를 포함합니다.
`plugins-runtime-install-a`부터 `plugins-runtime-install-h`까지	병렬 릴리스 검증을 위해 분할된 Plugin 설치/런타임 배치.

Docker 레인 하나만 실패한 경우 재사용 가능한 라이브/E2E 워크플로에서 대상 지정 docker_lanes=<lane[,lane]>을 사용합니다. 릴리스 아티팩트에는 사용 가능한 경우 패키지 아티팩트 및 이미지 재사용 입력이 포함된 레인별 재실행 명령이 포함됩니다.

릴리스 프로필

release_profile은 주로 릴리스 검사 내부의 라이브/제공자 범위를 제어합니다. 일반 전체 CI, Plugin Prerelease, 설치 스모크, 패키지 승인 또는 QA Lab은 제거하지 않습니다. stable의 경우 전체 저장소/라이브 E2E 및 Docker 릴리스 경로 청크는 소크 범위이며 run_release_soak=true일 때 실행됩니다. full은 소크 범위를 강제로 켜고, rerun_group=all일 때 상위 릴리스 패키지 아티팩트에 대해 엄브렐라 실행이 패키지 Telegram E2E도 실행하게 하므로, 전체 사전 게시 후보가 해당 Telegram 패키지 레인을 조용히 건너뛰지 않습니다.

프로필	의도한 용도	포함된 라이브/제공자 범위
`minimum`	가장 빠른 릴리스 중요 스모크.	OpenAI/core 라이브 경로, OpenAI용 Docker 라이브 모델, 네이티브 Gateway core, 네이티브 OpenAI Gateway 프로필, 네이티브 OpenAI Plugin, Docker 라이브 Gateway OpenAI.
`stable`	기본 릴리스 승인 프로필.	`minimum`에 Anthropic 스모크, Google, MiniMax, 백엔드, 네이티브 라이브 테스트 하니스, Docker 라이브 CLI 백엔드, Docker ACP 바인드, Docker Codex 하니스, OpenCode Go 스모크 샤드 추가.
`full`	광범위한 자문 스윕.	`stable`에 자문 제공자, Plugin 라이브 샤드, 미디어 라이브 샤드 추가.

`full` 전용 추가 항목

이 스위트는 stable에서 건너뛰고 full에 포함됩니다.

영역	`full` 전용 범위
Docker 라이브 모델	OpenCode Go, OpenRouter, xAI, Z.ai, Fireworks.
Docker 라이브 Gateway	DeepSeek/Fireworks, OpenCode Go/OpenRouter, xAI/Z.ai 샤드로 분할된 자문 제공자.
네이티브 Gateway 제공자 프로필	전체 Anthropic Opus 및 Sonnet/Haiku 샤드, Fireworks, DeepSeek, 전체 OpenCode Go 모델 샤드, OpenRouter, xAI, Z.ai.
네이티브 Plugin 라이브 샤드	Plugin A-K, L-N, O-Z 기타, Moonshot, xAI.
네이티브 미디어 라이브 샤드	오디오, Google 음악, MiniMax 음악, 비디오 그룹 A-D.

stable은 native-live-src-gateway-profiles-anthropic-smoke 및 native-live-src-gateway-profiles-opencode-go-smoke를 포함하고, full은 대신 더 넓은 Anthropic 및 OpenCode Go 모델 샤드를 사용합니다. 집중 재실행은 여전히 집계 native-live-src-gateway-profiles-anthropic 또는 native-live-src-gateway-profiles-opencode-go 핸들을 사용할 수 있습니다.

집중 재실행

관련 없는 릴리스 박스를 반복하지 않으려면 rerun_group을 사용하세요:

핸들	범위
`all`	모든 전체 릴리스 검증 단계.
`ci`	수동 전체 CI 하위 항목만.
`plugin-prerelease`	Plugin 사전 릴리스 하위 항목만.
`release-checks`	모든 OpenClaw 릴리스 검사 단계.
`install-smoke`	설치 스모크부터 릴리스 검사까지.
`cross-os`	크로스 OS 릴리스 검사.
`live-e2e`	저장소/라이브 E2E 및 Docker 릴리스 경로 검증.
`package`	패키지 승인.
`qa`	QA 패리티와 QA 라이브 레인.
`qa-parity`	QA 패리티 레인 및 보고서만.
`qa-live`	QA 라이브 Matrix 및 Telegram만.
`npm-telegram`	게시된 패키지 Telegram E2E; `release_package_spec` 또는 `npm_telegram_package_spec`가 필요합니다.

하나의 라이브 스위트가 실패했을 때 rerun_group=live-e2e와 함께 live_suite_filter를 사용합니다. 유효한 필터 ID는 재사용 가능한 라이브/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. live-gateway-advisory-docker 핸들은 세 제공자 샤드에 대한 집계 재실행 핸들이므로, 여전히 모든 권고 Docker Gateway 작업으로 확장됩니다. 하나의 크로스 OS 레인이 실패했을 때 rerun_group=cross-os와 함께 cross_os_suite_filter를 사용합니다. 필터는 OS ID, 스위트 ID 또는 OS/스위트 쌍을 허용합니다. 예를 들어 windows/packaged-upgrade, windows, 또는 packaged-fresh입니다. 크로스 OS 요약에는 패키지된 업그레이드 레인에 대한 단계별 시간이 포함되며, 오래 실행되는 명령은 하트비트 줄을 출력하므로 작업 시간 초과 전에 멈춘 Windows 업데이트를 볼 수 있습니다. QA 릴리스 검사 레인은 권고용입니다. QA 전용 실패는 경고로 보고되며 릴리스 검사 검증기를 차단하지 않습니다. 최신 QA 증거가 필요할 때는 rerun_group=qa, qa-parity 또는 qa-live를 다시 실행하세요.

보관할 증거

릴리스 수준 색인으로 Full Release Validation 요약을 보관하세요. 이 요약은 하위 실행 ID를 연결하고 가장 느린 작업 테이블을 포함합니다. 실패 시에는 먼저 하위 워크플로를 검사한 다음, 위에서 가장 작은 일치 핸들을 다시 실행하세요. 유용한 아티팩트:

전체 릴리스 검증 상위 항목 및 OpenClaw Release Checks의 release-package-under-test
.artifacts/docker-tests/ 아래의 Docker 릴리스 경로 아티팩트
패키지 승인 package-under-test 및 Docker 승인 아티팩트
각 OS와 스위트에 대한 크로스 OS 릴리스 검사 아티팩트
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

Documentation Index

​최상위 단계

​릴리스 검사 단계

​Docker 릴리스 경로 청크

​릴리스 프로필

​full 전용 추가 항목

​집중 재실행

​보관할 증거

​워크플로 파일