Full release validation

Full release validation 문서는 OpenClaw 공식 문서(reference/full-release-validation)를 한국어로 정리한 가이드입니다. Full Release Validation stages, child workflows, release profiles, rerun handles, and evidence 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Full Release Validation stages, child workflows, release profiles, rerun handles, and evidence

한국어 가이드 범위: reference/full-release-validation 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Extended-stable exception
Top-level stages
Release checks stages
Docker release-path chunks
Release profiles
Full-only additions
Focused reruns
Evidence to keep
Workflow files

상세 내용

본문

Full Release Validation is the release product-validation umbrella. Most work happens in child workflows so a failed box can be rerun without restarting the whole release. Run release preparation before freezing the Code SHA; it refreshes Control UI locale output when the background bot has not landed it yet, then enforces the same strict zero-fallback check used by release CI.

pnpm ci:full-release \
  --sha <code-sha> \
  --target-ref release/YYYY.M.PATCH

Extended-stable exception

Extended-stable publish requires a run whose workflow and target are both the canonical branch:

gh workflow run full-release-validation.yml \
  --ref extended-stable/YYYY.M.33 \
  -f ref=extended-stable/YYYY.M.33 \
  -f release_profile=stable

Top-level stages

For rerun_group=all, a Check for reusable validation evidence job runs first. It looks for the newest prior green full validation with the same release profile, effective soak setting, and validation inputs. Exact-target reruns use exact-target-full-validation-v1. A descendant whose complete delta is exactly CHANGELOG.md uses changelog-only-release-v1; every product lane is skipped and the verifier independently rechecks the GitHub commit comparison, immutable parent artifact, child runs, and dispatch logs. Any other target change requires a fresh Code SHA validation. Pass reuse_evidence=false to force a fresh full run. Evidence reuse runs only from main or a canonical SHA-pinned release-ci/* ref whose workflow commit remains on trusted main lineage; other workflow refs run the selected lanes fresh.

Stage	Details
Target resolution	Job: `Resolve target ref` Child workflow: none Proves: resolves the release branch, tag, or full commit SHA and records selected inputs. Rerun: rerun the umbrella if this fails.
Shared candidate	Job: `Prepare shared release candidate` Child workflow: `OpenClaw Live And E2E Checks (Reusable)` Proves: packs and validates one exact-SHA package, builds one functional Docker image, and records immutable package and image artifact tuples for both package-facing child workflows. Rerun: rerun the affected package, plugin-prerelease, cross-OS, or live/E2E group.
Docker assets preflight	Job: `Verify Docker runtime image assets` Child workflow: none Proves: the `runtime-assets` Docker build target still succeeds before any other stage dispatches. Runs only for `rerun_group=all`. Rerun: rerun the umbrella with `rerun_group=all`.
Vitest and normal CI	Job: `Run normal full CI` Child workflow: `CI` Proves: manual full CI graph against the target ref, including Linux Node lanes, bundled plugin shards, plugin and channel contract shards, Node 22 compatibility, `check-`, `check-additional-`, built-artifact smoke checks, docs checks, Python skills, Windows, macOS, Control UI i18n, and Android via the umbrella. Rerun: `rerun_group=ci`.
Plugin prerelease	Job: `Run plugin prerelease validation` Child workflow: `Plugin Prerelease` Proves: release-only plugin static checks, agentic plugin coverage, full plugin batch shards, plugin prerelease Docker lanes, and a non-blocking `plugin-inspector-advisory` artifact for compatibility triage. Rerun: `rerun_group=plugin-prerelease`.
Release checks	Job: `Run release/live/Docker/QA validation` Child workflow: `OpenClaw Release Checks` Proves: install smoke, cross-OS package checks, Package Acceptance, QA Lab parity, live Matrix and Telegram, plus gated advisory Discord, WhatsApp, and Slack lanes. Stable and full profiles also run exhaustive live/E2E suites and Docker release-path chunks; beta can opt in with `run_release_soak=true`. Rerun: `rerun_group=release-checks` or a narrower release-checks handle.
Package Telegram	Job: `Run package Telegram E2E` Child workflow: `NPM Telegram Beta E2E` Proves: a focused published-package Telegram E2E when `release_package_spec` or `npm_telegram_package_spec` is set. Full candidate validation uses the canonical Package Acceptance Telegram E2E instead. Rerun: `rerun_group=npm-telegram` with `release_package_spec` or `npm_telegram_package_spec`.
Product performance	Job: `Run product performance evidence` Child workflow: `OpenClaw Performance` Proves: release-profile performance run (`profile=release`, `repeat=3`, `fail_on_regression=true`, `publish_reports=false`) against the target SHA. Kova output stays in workflow artifacts and the child must prove its report publisher was skipped. Required (blocking) only for `rerun_group=all` or `rerun_group=performance`; not required for narrower rerun groups. Rerun: `rerun_group=performance`.
Umbrella verifier	Job: `Verify full validation` Child workflow: none Proves: re-checks recorded child run conclusions and appends slowest-job tables from child workflows. Rerun: rerun only this job after rerunning a failed child to green.

Release checks stages

OpenClaw Release Checks is the largest child workflow. It resolves the target once and validates the umbrella's shared package artifact when available. A direct or focused dispatch prepares its own release-package-under-test artifact when package or Docker-facing stages need it.

Stage	Details
Release target	Job: `Resolve target ref` Backing workflow: none Tests: selected ref, optional expected SHA, profile, rerun group, and focused live suite filter. Rerun: `rerun_group=release-checks`.
Package artifact	Job: `Prepare release package artifact` Backing workflow: none Tests: validates the umbrella's immutable package tuple, or packs one candidate tarball for a direct/focused Release Checks dispatch, then exposes it to downstream package-facing checks. Rerun: the affected package, cross-OS, or live/E2E group.
Install smoke	Job: `Run install smoke` Backing workflow: `Install Smoke` Tests: full install path with root Dockerfile smoke image reuse, QR package install, root and gateway Docker smokes, installer Docker tests, and Bun global install image-provider smoke. Rerun: `rerun_group=install-smoke`.
Cross-OS	Job: `cross_os_release_checks` Backing workflow: `OpenClaw Cross-OS Release Checks (Reusable)` Tests: fresh and upgrade lanes on Linux, Windows, and macOS for the selected provider and mode, using the candidate tarball plus a baseline package. Rerun: `rerun_group=cross-os`.
Repo and live E2E	Job: `Run repo/live E2E validation` Backing workflow: `OpenClaw Live And E2E Checks (Reusable)` Tests: repository E2E, live cache, OpenAI websocket streaming, native live provider and plugin shards, and Docker-backed live model/backend/gateway harnesses selected by `release_profile`. Runs: `run_release_soak=true`, `release_profile=full`, or focused `rerun_group=live-e2e`. Rerun: `rerun_group=live-e2e`, optionally with `live_suite_filter`.
Docker release path	Job: `Run Docker release-path validation` Backing workflow: `OpenClaw Live And E2E Checks (Reusable)` Tests: release-path Docker chunks against the shared package artifact. Runs: `run_release_soak=true`, `release_profile=full`, or focused `rerun_group=live-e2e`. Rerun: `rerun_group=live-e2e`.
Package Acceptance	Job: `Run package acceptance` Backing workflow: `Package Acceptance` Tests: offline plugin package fixtures, plugin update, the canonical mock-OpenAI Telegram package E2E, and published-upgrade survivor checks against the same tarball. Blocking release checks use the default latest published baseline; soak checks (`run_release_soak=true`) expand to the last 4 stable npm releases plus 3 pinned historical versions (`2026.4.23`, `2026.5.2`, `2026.4.15`), run against reported-issue upgrade fixtures. Rerun: `rerun_group=package`.
Maturity scorecard	Job: `Render maturity scorecard release docs` Backing workflow: `maturity-scorecard.yml` Tests: renders the advisory maturity scorecard docs against the target ref. Only runs when `run_maturity_scorecard=true` is passed. Rerun: `rerun_group=qa` with `run_maturity_scorecard=true`.
QA parity	Job: `Run QA Lab parity lane` and `Run QA Lab parity report` Backing workflow: direct jobs Tests: candidate and baseline agentic parity packs, then the parity report. Rerun: `rerun_group=qa-parity` or `rerun_group=qa`.
QA runtime parity	Job: `Verify QA Lab runtime-pair lanes` Backing workflow: direct job Tests: the canonical core `openclaw`/`codex` lane (`pnpm openclaw qa suite --runtime-pair openclaw,codex --runtime-pair-lane core`) and, with `run_release_soak=true`, the soak lane. Advisory: individual lane jobs do not block the release-check verifier. Rerun: `rerun_group=qa-parity` or `rerun_group=qa`.
QA runtime tool coverage	Job: `Enforce QA Lab runtime tool coverage` Backing workflow: direct job Tests: dynamic tool drift between `openclaw` and `codex` in the canonical core runtime-pair lane (`pnpm openclaw qa coverage --tools`), using that lane's output. Blocking: this job is not advisory-overridable. Rerun: `rerun_group=qa-parity` or `rerun_group=qa`.
QA live Matrix	Job: `Run QA Live Matrix profile` Backing workflow: `QA-Lab - All Lanes` reusable workflow Tests: parity-proven YAML scenarios through the shared Matrix live adapter in the `qa-live-shared` environment. Rerun: `rerun_group=qa-live` or `rerun_group=qa`; use `live_suite_filter=qa-live-matrix` for a focused Matrix rerun.
QA live Telegram	Job: `Run QA Lab live Telegram lane` Backing workflow: trusted `OpenClaw Release Telegram QA` dispatch Tests: live Telegram QA with Convex CI credential leases. Rerun: `rerun_group=qa-live` or `rerun_group=qa`.
QA live Discord	Job: `Run QA Lab live Discord lane` Backing workflow: direct advisory job Tests: live Discord QA with Convex CI credential leases when `OPENCLAW_RELEASE_QA_DISCORD_LIVE_CI_ENABLED` is enabled. Rerun: `rerun_group=qa-live` with `live_suite_filter=qa-live-discord`.
QA live WhatsApp	Job: `Run QA Lab live WhatsApp lane` Backing workflow: direct advisory job Tests: live WhatsApp QA with Convex CI credential leases when `OPENCLAW_RELEASE_QA_WHATSAPP_LIVE_CI_ENABLED` is enabled. Rerun: `rerun_group=qa-live` with `live_suite_filter=qa-live-whatsapp`.
QA live Slack	Job: `Run QA Lab live Slack lane` Backing workflow: direct advisory job Tests: live Slack QA with Convex CI credential leases when `OPENCLAW_RELEASE_QA_SLACK_LIVE_CI_ENABLED` is enabled. Rerun: `rerun_group=qa-live` with `live_suite_filter=qa-live-slack`.
Release verifier	Job: `Verify release checks` Backing workflow: none Tests: required release-check jobs for the selected rerun group. Rerun: rerun after focused child jobs pass.

Docker release-path chunks

The Docker release-path stage runs these chunks when live_suite_filter is empty:

Chunk	Coverage
`core`	Core Docker release-path smoke lanes.
`package-update-openai`	OpenAI package install/update behavior, Codex on-demand install, Codex plugin live progress follow-through, and Chat Completions tool calls.
`package-update-anthropic`	Anthropic package install and update behavior.
`package-update-core`	Provider-neutral package and update behavior.
`plugins-runtime-plugins`	Plugin runtime lanes that exercise plugin behavior.
`plugins-runtime-services`	Service-backed and live plugin runtime lanes.
`plugins-runtime-install-a` through `plugins-runtime-install-h`	Plugin install/runtime batches split for parallel release validation.
`openwebui`	OpenWebUI compatibility smoke isolated on a dedicated large-disk runner when requested.

Release profiles

release_profile mostly controls live/provider breadth inside release checks. It does not remove normal full CI, Plugin Prerelease, install smoke, package acceptance, or QA Lab. Stable and full profiles always run exhaustive repo/live E2E and Docker release-path soak coverage. The beta profile can opt in with run_release_soak=true. Package Acceptance supplies the canonical package Telegram E2E for every full candidate, so the umbrella does not duplicate that live poller.

Profile	Intended use	Included live/provider coverage
`beta`	Fastest release-critical smoke.	OpenAI/core live path, Docker live models for OpenAI, native gateway core, native OpenAI gateway profile, native OpenAI plugin, and Docker live gateway OpenAI.
`stable`	Default release approval profile.	`beta` plus Anthropic smoke, Google, MiniMax, backend, native live test harness, Docker live CLI backend, Docker ACP bind, Docker Codex harness, Docker subagent-announce, and an OpenCode Go smoke shard.
`full`	Broad advisory sweep.	`stable` plus advisory providers, plugin live shards, and media live shards.

Full-only additions

These suites are skipped by stable and included by full:

Area	Full-only coverage
Docker live models	OpenCode Go, OpenRouter, xAI, Z.ai, and Fireworks.
Docker live gateway	Advisory providers split into DeepSeek/Fireworks, OpenCode Go/OpenRouter, and xAI/Z.ai shards.
Native gateway provider profiles	Full Anthropic Opus and Sonnet/Haiku shards, Fireworks, DeepSeek, full OpenCode Go model shards, OpenRouter, xAI, and Z.ai.
Native plugin live shards	Plugins A-K, L-N, O-Z other, Moonshot, and xAI.
Native media live shards	Audio, Google music, MiniMax music, and video groups A-D.

Focused reruns

Use rerun_group to avoid repeating unrelated release boxes:

Handle	Scope
`all`	All Full Release Validation stages.
`ci`	Manual full CI child only.
`plugin-prerelease`	Plugin Prerelease child only.
`release-checks`	All OpenClaw Release Checks stages.
`install-smoke`	Install Smoke through release checks.
`cross-os`	Cross-OS release checks.
`live-e2e`	Repo/live E2E and Docker release-path validation.
`package`	Package Acceptance.
`qa`	QA parity plus QA live lanes.
`qa-parity`	QA parity lanes and report only.
`qa-live`	QA live Matrix/Telegram plus gated Discord, WhatsApp, and Slack lanes when enabled.
`npm-telegram`	Published-package Telegram E2E; requires `release_package_spec` or `npm_telegram_package_spec`.
`performance`	Product performance evidence only.

Evidence to keep

Keep the Full Release Validation summary as the release-level index. It links child run ids and includes slowest-job tables. For failures, inspect the child workflow first, then rerun the smallest matching handle above.

주요 항목:

release-package-under-test from OpenClaw Release Checks
Docker release-path artifacts under .artifacts/docker-tests/
Package Acceptance package-under-test and Docker acceptance artifacts
Cross-OS release-check artifacts for each OS and suite
QA parity, runtime parity, and selected Matrix, Telegram, Discord, WhatsApp,

Workflow files

주요 항목:

.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/install-smoke-reusable.yml
.github/workflows/openclaw-cross-os-release-checks-reusable.yml
.github/workflows/package-acceptance.yml
.github/workflows/openclaw-performance.yml
.github/workflows/npm-telegram-beta-e2e.yml

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/reference/full-release-validation
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

pnpm ci:full-release \
  --sha <code-sha> \
  --target-ref release/YYYY.M.PATCH

gh workflow run full-release-validation.yml \
  --ref extended-stable/YYYY.M.33 \
  -f ref=extended-stable/YYYY.M.33 \
  -f release_profile=stable

Full release validation

핵심 요약

Full Release Validation stages, child workflows, release profiles, rerun handles, and evidence

한국어 가이드 범위: reference/full-release-validation 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Extended-stable exception
Top-level stages
Release checks stages
Docker release-path chunks
Release profiles
Full-only additions
Focused reruns
Evidence to keep
Workflow files

상세 내용

본문

pnpm ci:full-release \
  --sha <code-sha> \
  --target-ref release/YYYY.M.PATCH

Extended-stable exception

Extended-stable publish requires a run whose workflow and target are both the canonical branch:

gh workflow run full-release-validation.yml \
  --ref extended-stable/YYYY.M.33 \
  -f ref=extended-stable/YYYY.M.33 \
  -f release_profile=stable

Top-level stages

Stage	Details
Target resolution	Job: `Resolve target ref` Child workflow: none Proves: resolves the release branch, tag, or full commit SHA and records selected inputs. Rerun: rerun the umbrella if this fails.
Shared candidate	Job: `Prepare shared release candidate` Child workflow: `OpenClaw Live And E2E Checks (Reusable)` Proves: packs and validates one exact-SHA package, builds one functional Docker image, and records immutable package and image artifact tuples for both package-facing child workflows. Rerun: rerun the affected package, plugin-prerelease, cross-OS, or live/E2E group.
Docker assets preflight	Job: `Verify Docker runtime image assets` Child workflow: none Proves: the `runtime-assets` Docker build target still succeeds before any other stage dispatches. Runs only for `rerun_group=all`. Rerun: rerun the umbrella with `rerun_group=all`.
Vitest and normal CI	Job: `Run normal full CI` Child workflow: `CI` Proves: manual full CI graph against the target ref, including Linux Node lanes, bundled plugin shards, plugin and channel contract shards, Node 22 compatibility, `check-`, `check-additional-`, built-artifact smoke checks, docs checks, Python skills, Windows, macOS, Control UI i18n, and Android via the umbrella. Rerun: `rerun_group=ci`.
Plugin prerelease	Job: `Run plugin prerelease validation` Child workflow: `Plugin Prerelease` Proves: release-only plugin static checks, agentic plugin coverage, full plugin batch shards, plugin prerelease Docker lanes, and a non-blocking `plugin-inspector-advisory` artifact for compatibility triage. Rerun: `rerun_group=plugin-prerelease`.
Release checks	Job: `Run release/live/Docker/QA validation` Child workflow: `OpenClaw Release Checks` Proves: install smoke, cross-OS package checks, Package Acceptance, QA Lab parity, live Matrix and Telegram, plus gated advisory Discord, WhatsApp, and Slack lanes. Stable and full profiles also run exhaustive live/E2E suites and Docker release-path chunks; beta can opt in with `run_release_soak=true`. Rerun: `rerun_group=release-checks` or a narrower release-checks handle.
Package Telegram	Job: `Run package Telegram E2E` Child workflow: `NPM Telegram Beta E2E` Proves: a focused published-package Telegram E2E when `release_package_spec` or `npm_telegram_package_spec` is set. Full candidate validation uses the canonical Package Acceptance Telegram E2E instead. Rerun: `rerun_group=npm-telegram` with `release_package_spec` or `npm_telegram_package_spec`.
Product performance	Job: `Run product performance evidence` Child workflow: `OpenClaw Performance` Proves: release-profile performance run (`profile=release`, `repeat=3`, `fail_on_regression=true`, `publish_reports=false`) against the target SHA. Kova output stays in workflow artifacts and the child must prove its report publisher was skipped. Required (blocking) only for `rerun_group=all` or `rerun_group=performance`; not required for narrower rerun groups. Rerun: `rerun_group=performance`.
Umbrella verifier	Job: `Verify full validation` Child workflow: none Proves: re-checks recorded child run conclusions and appends slowest-job tables from child workflows. Rerun: rerun only this job after rerunning a failed child to green.

Release checks stages

Stage	Details
Release target	Job: `Resolve target ref` Backing workflow: none Tests: selected ref, optional expected SHA, profile, rerun group, and focused live suite filter. Rerun: `rerun_group=release-checks`.
Package artifact	Job: `Prepare release package artifact` Backing workflow: none Tests: validates the umbrella's immutable package tuple, or packs one candidate tarball for a direct/focused Release Checks dispatch, then exposes it to downstream package-facing checks. Rerun: the affected package, cross-OS, or live/E2E group.
Install smoke	Job: `Run install smoke` Backing workflow: `Install Smoke` Tests: full install path with root Dockerfile smoke image reuse, QR package install, root and gateway Docker smokes, installer Docker tests, and Bun global install image-provider smoke. Rerun: `rerun_group=install-smoke`.
Cross-OS	Job: `cross_os_release_checks` Backing workflow: `OpenClaw Cross-OS Release Checks (Reusable)` Tests: fresh and upgrade lanes on Linux, Windows, and macOS for the selected provider and mode, using the candidate tarball plus a baseline package. Rerun: `rerun_group=cross-os`.
Repo and live E2E	Job: `Run repo/live E2E validation` Backing workflow: `OpenClaw Live And E2E Checks (Reusable)` Tests: repository E2E, live cache, OpenAI websocket streaming, native live provider and plugin shards, and Docker-backed live model/backend/gateway harnesses selected by `release_profile`. Runs: `run_release_soak=true`, `release_profile=full`, or focused `rerun_group=live-e2e`. Rerun: `rerun_group=live-e2e`, optionally with `live_suite_filter`.
Docker release path	Job: `Run Docker release-path validation` Backing workflow: `OpenClaw Live And E2E Checks (Reusable)` Tests: release-path Docker chunks against the shared package artifact. Runs: `run_release_soak=true`, `release_profile=full`, or focused `rerun_group=live-e2e`. Rerun: `rerun_group=live-e2e`.
Package Acceptance	Job: `Run package acceptance` Backing workflow: `Package Acceptance` Tests: offline plugin package fixtures, plugin update, the canonical mock-OpenAI Telegram package E2E, and published-upgrade survivor checks against the same tarball. Blocking release checks use the default latest published baseline; soak checks (`run_release_soak=true`) expand to the last 4 stable npm releases plus 3 pinned historical versions (`2026.4.23`, `2026.5.2`, `2026.4.15`), run against reported-issue upgrade fixtures. Rerun: `rerun_group=package`.
Maturity scorecard	Job: `Render maturity scorecard release docs` Backing workflow: `maturity-scorecard.yml` Tests: renders the advisory maturity scorecard docs against the target ref. Only runs when `run_maturity_scorecard=true` is passed. Rerun: `rerun_group=qa` with `run_maturity_scorecard=true`.
QA parity	Job: `Run QA Lab parity lane` and `Run QA Lab parity report` Backing workflow: direct jobs Tests: candidate and baseline agentic parity packs, then the parity report. Rerun: `rerun_group=qa-parity` or `rerun_group=qa`.
QA runtime parity	Job: `Verify QA Lab runtime-pair lanes` Backing workflow: direct job Tests: the canonical core `openclaw`/`codex` lane (`pnpm openclaw qa suite --runtime-pair openclaw,codex --runtime-pair-lane core`) and, with `run_release_soak=true`, the soak lane. Advisory: individual lane jobs do not block the release-check verifier. Rerun: `rerun_group=qa-parity` or `rerun_group=qa`.
QA runtime tool coverage	Job: `Enforce QA Lab runtime tool coverage` Backing workflow: direct job Tests: dynamic tool drift between `openclaw` and `codex` in the canonical core runtime-pair lane (`pnpm openclaw qa coverage --tools`), using that lane's output. Blocking: this job is not advisory-overridable. Rerun: `rerun_group=qa-parity` or `rerun_group=qa`.
QA live Matrix	Job: `Run QA Live Matrix profile` Backing workflow: `QA-Lab - All Lanes` reusable workflow Tests: parity-proven YAML scenarios through the shared Matrix live adapter in the `qa-live-shared` environment. Rerun: `rerun_group=qa-live` or `rerun_group=qa`; use `live_suite_filter=qa-live-matrix` for a focused Matrix rerun.
QA live Telegram	Job: `Run QA Lab live Telegram lane` Backing workflow: trusted `OpenClaw Release Telegram QA` dispatch Tests: live Telegram QA with Convex CI credential leases. Rerun: `rerun_group=qa-live` or `rerun_group=qa`.
QA live Discord	Job: `Run QA Lab live Discord lane` Backing workflow: direct advisory job Tests: live Discord QA with Convex CI credential leases when `OPENCLAW_RELEASE_QA_DISCORD_LIVE_CI_ENABLED` is enabled. Rerun: `rerun_group=qa-live` with `live_suite_filter=qa-live-discord`.
QA live WhatsApp	Job: `Run QA Lab live WhatsApp lane` Backing workflow: direct advisory job Tests: live WhatsApp QA with Convex CI credential leases when `OPENCLAW_RELEASE_QA_WHATSAPP_LIVE_CI_ENABLED` is enabled. Rerun: `rerun_group=qa-live` with `live_suite_filter=qa-live-whatsapp`.
QA live Slack	Job: `Run QA Lab live Slack lane` Backing workflow: direct advisory job Tests: live Slack QA with Convex CI credential leases when `OPENCLAW_RELEASE_QA_SLACK_LIVE_CI_ENABLED` is enabled. Rerun: `rerun_group=qa-live` with `live_suite_filter=qa-live-slack`.
Release verifier	Job: `Verify release checks` Backing workflow: none Tests: required release-check jobs for the selected rerun group. Rerun: rerun after focused child jobs pass.

Docker release-path chunks

The Docker release-path stage runs these chunks when live_suite_filter is empty:

Chunk	Coverage
`core`	Core Docker release-path smoke lanes.
`package-update-openai`	OpenAI package install/update behavior, Codex on-demand install, Codex plugin live progress follow-through, and Chat Completions tool calls.
`package-update-anthropic`	Anthropic package install and update behavior.
`package-update-core`	Provider-neutral package and update behavior.
`plugins-runtime-plugins`	Plugin runtime lanes that exercise plugin behavior.
`plugins-runtime-services`	Service-backed and live plugin runtime lanes.
`plugins-runtime-install-a` through `plugins-runtime-install-h`	Plugin install/runtime batches split for parallel release validation.
`openwebui`	OpenWebUI compatibility smoke isolated on a dedicated large-disk runner when requested.

Release profiles

Profile	Intended use	Included live/provider coverage
`beta`	Fastest release-critical smoke.	OpenAI/core live path, Docker live models for OpenAI, native gateway core, native OpenAI gateway profile, native OpenAI plugin, and Docker live gateway OpenAI.
`stable`	Default release approval profile.	`beta` plus Anthropic smoke, Google, MiniMax, backend, native live test harness, Docker live CLI backend, Docker ACP bind, Docker Codex harness, Docker subagent-announce, and an OpenCode Go smoke shard.
`full`	Broad advisory sweep.	`stable` plus advisory providers, plugin live shards, and media live shards.

Full-only additions

These suites are skipped by stable and included by full:

Area	Full-only coverage
Docker live models	OpenCode Go, OpenRouter, xAI, Z.ai, and Fireworks.
Docker live gateway	Advisory providers split into DeepSeek/Fireworks, OpenCode Go/OpenRouter, and xAI/Z.ai shards.
Native gateway provider profiles	Full Anthropic Opus and Sonnet/Haiku shards, Fireworks, DeepSeek, full OpenCode Go model shards, OpenRouter, xAI, and Z.ai.
Native plugin live shards	Plugins A-K, L-N, O-Z other, Moonshot, and xAI.
Native media live shards	Audio, Google music, MiniMax music, and video groups A-D.

Focused reruns

Use rerun_group to avoid repeating unrelated release boxes:

Handle	Scope
`all`	All Full Release Validation stages.
`ci`	Manual full CI child only.
`plugin-prerelease`	Plugin Prerelease child only.
`release-checks`	All OpenClaw Release Checks stages.
`install-smoke`	Install Smoke through release checks.
`cross-os`	Cross-OS release checks.
`live-e2e`	Repo/live E2E and Docker release-path validation.
`package`	Package Acceptance.
`qa`	QA parity plus QA live lanes.
`qa-parity`	QA parity lanes and report only.
`qa-live`	QA live Matrix/Telegram plus gated Discord, WhatsApp, and Slack lanes when enabled.
`npm-telegram`	Published-package Telegram E2E; requires `release_package_spec` or `npm_telegram_package_spec`.
`performance`	Product performance evidence only.

Evidence to keep

주요 항목:

release-package-under-test from OpenClaw Release Checks
Docker release-path artifacts under .artifacts/docker-tests/
Package Acceptance package-under-test and Docker acceptance artifacts
Cross-OS release-check artifacts for each OS and suite
QA parity, runtime parity, and selected Matrix, Telegram, Discord, WhatsApp,

Workflow files

주요 항목:

.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/install-smoke-reusable.yml
.github/workflows/openclaw-cross-os-release-checks-reusable.yml
.github/workflows/package-acceptance.yml
.github/workflows/openclaw-performance.yml
.github/workflows/npm-telegram-beta-e2e.yml

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/reference/full-release-validation
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

pnpm ci:full-release \
  --sha <code-sha> \
  --target-ref release/YYYY.M.PATCH

gh workflow run full-release-validation.yml \
  --ref extended-stable/YYYY.M.33 \
  -f ref=extended-stable/YYYY.M.33 \
  -f release_profile=stable

Full release validation

핵심 요약

문서 구성

상세 내용

본문

Extended-stable exception

Top-level stages

Release checks stages

Docker release-path chunks

Release profiles

Full-only additions

Focused reruns

Evidence to keep

Workflow files

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

Full release validation

핵심 요약

문서 구성

상세 내용

본문

Extended-stable exception

Top-level stages

Release checks stages

Docker release-path chunks

Release profiles

Full-only additions

Focused reruns

Evidence to keep

Workflow files

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드