> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# CI 파이프라인

> OpenClaw CI 파이프라인 작동 방식

# CI 파이프라인

CI는 `main`에 대한 모든 푸시와 모든 풀 리퀘스트에서 실행됩니다. 관련 없는 영역만 변경된 경우 비용이 큰 작업을 건너뛰기 위해 스마트 스코핑을 사용합니다.

## 작업 개요

| 작업                | 목적                                      | 실행 시점               |
| ----------------- | --------------------------------------- | ------------------- |
| `docs-scope`      | 문서만 변경되었는지 감지                           | 항상                  |
| `changed-scope`   | 변경된 영역 감지 (node/macos/android/windows)  | 문서 외 변경             |
| `check`           | TypeScript 타입, 린트, 포맷                   | 문서 외, node 변경       |
| `check-docs`      | Markdown 린트 + 깨진 링크 검사                  | 문서 변경 시             |
| `secrets`         | 유출된 시크릿 감지                              | 항상                  |
| `build-artifacts` | dist를 한 번 빌드하고 `release-check`와 공유      | `main` 푸시, node 변경  |
| `release-check`   | npm pack 콘텐츠 검증                         | `main` 푸시에서 빌드 후    |
| `checks`          | PR에서는 Node 테스트 + 프로토콜 검사, 푸시에서는 Bun 호환성 | 문서 외, node 변경       |
| `compat-node22`   | 최소 지원 Node 런타임 호환성                      | `main` 푸시, node 변경  |
| `checks-windows`  | Windows 전용 테스트                          | 문서 외, windows 관련 변경 |
| `macos`           | Swift 린트/빌드/테스트 + TS 테스트                | macos 변경이 있는 PR     |
| `android`         | Gradle 빌드 + 테스트                         | 문서 외, android 변경    |

## Fail-Fast 순서

비용이 적은 검사가 먼저 실패하도록 작업이 정렬됩니다:

1. `docs-scope` + `changed-scope` + `check` + `secrets` (병렬, 값싼 게이트 우선)
2. PR: `checks` (Linux Node 테스트 2개 샤드), `checks-windows`, `macos`, `android`
3. `main` 푸시: `build-artifacts` + `release-check` + Bun 호환성 + `compat-node22`

스코프 로직은 `scripts/ci-changed-scope.mjs`에 있으며, 단위 테스트는 `src/scripts/ci-changed-scope.test.ts`에 있습니다.

## 러너

| 러너                               | 작업                      |
| -------------------------------- | ----------------------- |
| `blacksmith-16vcpu-ubuntu-2404`  | 스코프 감지 포함 대부분의 Linux 작업 |
| `blacksmith-16vcpu-windows-2025` | `checks-windows`        |
| `macos-latest`                   | `macos`, `ios`          |

## 로컬 동등 명령어

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm check          # 타입 + 린트 + 포맷
pnpm test           # vitest 테스트
pnpm check:docs     # 문서 포맷 + 린트 + 깨진 링크
pnpm release:check  # npm pack 검증
```