Full Release Validation 是发布前的统一入口，大部分工作在子工作流中完成，单个失败的阶段可以单独重跑而无需重启整个发布流程。
触发方式
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子工作流使用可信 workflow ref 作为测试框架，使用输入 ref 作为待测候选版本。
顶层阶段
| 阶段 | 说明 |
|---|---|
| Target resolution | 解析发布分支/tag/commit SHA |
| Vitest and normal CI | 完整 CI 图（Linux/Windows/macOS/Android 等） |
| Plugin prerelease | 插件静态检查、agentic 覆盖、扩展批量分片 |
| Release checks | 安装冒烟、跨 OS 包检查、Package Acceptance、QA Lab |
| Package artifact | 打包候选 tarball |
| Package Telegram | Telegram 包端到端测试 |
| Umbrella verifier | 重新检查所有子运行结论，附加最慢任务表 |
发布配置（release_profile）
| Profile | 用途 | 覆盖范围 |
|---|---|---|
minimum | 最快发布关键冒烟 | OpenAI/core 核心路径 |
stable | 默认发布审批配置 | minimum + Anthropic/Google/MiniMax/backend |
full | 广泛建议性扫描 | stable + 建议性 provider、插件 live 分片、媒体 live 分片 |
stable 默认跳过 soak 测试，传 run_release_soak=true 可启用。full 始终启用 soak。
聚焦重跑（rerun_group）
| Handle | 范围 |
|---|---|
all | 所有阶段 |
ci | 仅 CI 子工作流 |
plugin-prerelease | 仅插件预发布 |
release-checks | 所有 Release Checks 阶段 |
install-smoke | 安装冒烟 |
cross-os | 跨 OS 检查 |
live-e2e | Repo/live E2E 和 Docker 发布路径 |
package | Package Acceptance |
qa | QA parity + QA live |
npm-telegram | 已发布包 Telegram E2E |
使用 live_suite_filter 配合 rerun_group=live-e2e 可精确重跑单个 live suite。
Docker 发布路径分片
| 分片 | 覆盖内容 |
|---|---|
core | 核心 Docker 发布路径冒烟 |
package-update-openai | OpenAI 包安装/更新、Codex 按需安装 |
package-update-anthropic | Anthropic 包安装和更新 |
plugins-runtime-plugins | 插件运行时行为 |
plugins-runtime-install-a ~ h | 插件安装/运行时批次（并行） |
需保留的证据
release-package-under-testartifact- Docker 发布路径 artifacts（
.artifacts/docker-tests/） - Package Acceptance artifacts
- 跨 OS 检查 artifacts
- QA parity、Matrix、Telegram artifacts
工作流文件
.github/workflows/full-release-validation.yml.github/workflows/openclaw-release-checks.yml.github/workflows/plugin-prerelease.yml.github/workflows/install-smoke.yml.github/workflows/package-acceptance.yml