OpenClaw 릴리스 CI

OpenClaw 릴리스 CI은(는) 무엇을 하나요?

릴리스 후보가 전체 유효성 검사, 설치/업데이트 증명, 라이브 프로바이더 확인 또는 CI 복구가 필요할 때 $openclaw-release-maintainer 및 $openclaw-testing과 함께 사용하세요.

가드레일

• 명시적인 운영자 승인 없이 버전 범프, 태그, npm 게시, GitHub 릴리스 또는 릴리스 승격을 수행하지 마십시오.
• 비용이 많이 드는 전체 릴리스 매트릭스를 디스패치하기 전에 프로바이더 시크릿의 유효성을 검증하십시오.
• 검증되지 않은 1Password 후보에서 GitHub 시크릿을 설정하지 마십시오. 후보가 401/403을 반환하면 기존 시크릿을 그대로 두고 정확히 누락된 프로바이더를 보고하십시오.
• 시크릿 읽기/쓰기에는 $one-password를 사용하십시오: 하나의 지속적인 tmux 세션, 대상 항목만, 시크릿 출력 금지.
• 하나의 부모 실행과 간결한 자식 요약을 관찰하십시오. 광범위한 gh run view 폴링 루프를 피하십시오. REST 할당량이 쉽게 소진됩니다.
• 실패했거나 현재 차단 중인 작업에 대해서만 로그를 가져오십시오. 할당량이 낮으면 폴링을 중지하고 재설정을 기다리십시오.
• 라이브 프로바이더 불안정 문제는 코드 실패와 별도로 처리하십시오. 코드를 편집하기 전에 키 유효성, 프로바이더 HTTP 상태, 재시도 증거 및 정확히 실패한 레인을 증명하십시오.

사전 점검

전체 릴리스 유효성 검사 전:

node .agents/skills/openclaw-release-ci/scripts/verify-provider-secrets.mjs --required openai,anthropic,fireworks
gh api rate_limit --jq '.resources.core'
git status --short --branch
git rev-parse HEAD

1Password 서비스 계정 값이 릴리스 프로바이더 사전 점검의 첫 번째 소스입니다. 먼저 해당 대상 키를 정확히 주입한 다음 검증기를 실행하십시오. 이 릴리스를 위해 의도적으로 주입된 경우에만 환경 변수를 사용하십시오. 스크립트는 프로바이더 상태와 HTTP 클래스만 출력하며 토큰은 절대 출력하지 않습니다.

디스패치

main 브랜치의 신뢰할 수 있는 워크플로우를 선호하고 정확한 릴리스 SHA를 대상으로 하십시오:

gh workflow run full-release-validation.yml \
  --repo openclaw/openclaw \
  --ref main \
  -f ref=<release-sha> \
  -f provider=openai \
  -f mode=both \
  -f release_profile=full \
  -f rerun_group=all

운영자가 명시적으로 광범위한 권고 프로바이더/미디어 매트릭스를 요청하지 않는 한 release_profile=stable을 사용하십시오. 집중 수정 후에는 좁은 rerun_group을 사용하십시오.

모니터링

반복적인 원시 폴링 대신 요약 헬퍼를 사용하십시오:

node .agents/skills/openclaw-release-ci/scripts/release-ci-summary.mjs <full-release-run-id>

그런 다음 유용할 때만 모니터링하십시오:

gh run watch <full-release-run-id> --repo openclaw/openclaw --exit-status

턴을 종료하거나 전략을 전환하기 전에 모니터링을 중지하십시오.

실패 트라이징

1. 부모 SHA와 자식 실행 ID를 확인합니다.
2. 실패한 작업만 나열합니다:

   gh run view <child-run-id> --repo openclaw/openclaw --json jobs \
     --jq '.jobs[] | select(.conclusion=="failure" or .conclusion=="timed_out" or .conclusion=="cancelled") | [.databaseId,.name,.conclusion,.url] | @tsv'
   

3. 하나의 실패한 작업 로그를 가져옵니다. 속도 제한이 걸리면 재설정 시간을 기록하고 더 이상의 REST 호출을 피합니다.
4. 시크릿 관련 실패처럼 보이면 코드를 편집하기 전에 동일한 시크릿 소스에서 프로바이더 엔드포인트를 검증합니다.
5. 라이브 캐시 실패의 경우 누락/잘못된 키, 빈 텍스트, 프로바이더 거부, 시간 초과 또는 기준선 누락인지 검사합니다. 명확한 프로바이더 증거 없이 릴리스 게이트를 약화시키지 마십시오.
6. 좁게 수정하고, 로컬/변경 증명을 실행하고, 커밋하고, 푸시하고, 가장 작은 일치 그룹을 다시 실행합니다.

증거

기록:

• 릴리스 SHA
• 전체 부모 실행 URL
• 자식 실행 ID 및 결과: CI, 릴리스 검사, 플러그인 사전 릴리스, NPM Telegram
• 대상 로컬 증명 명령어
• 프로바이더 시크릿 사전 점검 결과
• 알려진 격차 또는 관련 없는 실패

교훈 및 복구 패턴은 references/release-ci-notes.md를 읽으십시오.