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.
Full Release Validation은 릴리스 검증을 총괄하는 상위 워크플로입니다. 프리릴리스 증명을 위한 단일 수동 진입점이지만, 대부분의 작업은 하위 워크플로에서 수행되므로 실패한 박스만 전체 릴리스를 다시 시작하지 않고 재실행할 수 있습니다.
신뢰할 수 있는 워크플로 ref(일반적으로 main)에서 실행하고, 릴리스 브랜치, 태그 또는 전체 커밋 SHA를 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_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